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Présentation de la disquette 
: ToolBox-Mag n°4 


Nous ne nous lasserons jamais de le répéter. ToolBox Mag se tit GS 
. [en route: lisez la disquette! Voici son catalogue: 

| ANNONCES: nos petites annonces gratuites (pour les abonnés...) 
/BABAR: l'application à lancer MidiSynth.Play de Jean-Pierre Char- 
pentier, et ses sources. Explications pages 30-31. | 


/BORDER.SCROLL: le programme de Dominique Delay permettant 


d'agrandir l'écran de votre GS! Explications pages 22-23. 


IC.FACILE: 4e édition. F. Uhrich nous montre comment écrire des 


Inits en Orca/C et APW/C. C'quoi, un Init?” Voyez pages 10 à 12. 
ICRUNCH: contient les fichiers de l'animation Graphique-Son de pré- 
sentation de Ja disquette. Bootez la disquette, c'est du D. Delay. 
/DERNIERE.HEURE: nous avons réussi à garder quelques blocs sur le 
disque pour des infos ou corrections éventuelles de dernière minute. 
DIVERS: ce catalogue fourre-tout contient: 


* Bram.Util, application de J.L. Darbon. Voyez page 26. 
+ DefaultFile, fichier pour Genesys de J.Y Bourdin. Voir page 31. 


+ Franciser.5.04, fichier texte à lire où Yvan Kœnig explique com | 


ment il a francisé le système GS/0S 5.04. Voyez page 4. 

+ OteFinder.Data, un petit programme Applesoft du même 
Yvan Kœnig pour nettoyer les pollutions déposées par le Fin- 
der sur nos disques. | 

° Lancez.Moi et: GetVersion(.S}: un mini-programme et son 
source de J.Y. Bourdin. Voyez page 18. S'il vous dit que vous 
n'êtes pas à jour, c'est que vous ne l'êtes pas: voyez page 4. 


/FUN.BEYOND.GS: le super-jeu en six versions d'Olivier Goguel et du 


FTA. Plus le source, pour que vous fassiez la septième! Voir page 34. 
/GE80: le magnifique progiciel éditeur d'écrans 80 colonnes de Régis 
| Mange. Eh oui, tout en P8, et super-pro. Sans compter tout ce qu'il y 
a à repiquer dans les sources! Voyez pages 40 à 43. 
ICONS: icônes. 
/JOLLBUREAU.INIT: tout le nécessaire pour décorer votre bureau, en 
deux versions, de Patrick Desnoues. Voyez pages 5 à... 13! 
IMAC.ERASER: ou 524 octets pour le prix de 512, par Olivier Goguel. 
Voyez pages 16 à 18. 
/MACROS.APW: ou le 65832 par soft de Patrick Desnoues. Fonte ex- 
plications dans le fichier Lisez.Moi d'accompagnement. 
/PASCAL.INIT: vous l'aviez en C et en assembleur, le voici en Pascal, 
par Bernard Fournier. Voyez page 13. Si pre ça, vous gardez votre 
vieux bureau bleu, autant passer sur IBM! 
/RADIO.AMATEURS: trois fichiers texte à lire de Patrick Pointu. Quel 
rapport avec le GS? Voyez page 32. | 
IRAMTOOLS.INIT: ou le GS Roms 05 selon Patrick Desnoues. Voyez 
page 19. 
FRESSOURCES: 3e édition. Comment se modifier soi-même sans se 
mordre la queue, selon Bernard Fournier. Voir-pages 48-49. 
/TOOL219.V.1.1.1: dernière version du célèbre Tool de ToolBox Mag, 
par Olivier Goguel, avec un fichier de modifications du source. Mais 
aussi un catalogue /ORCAPASCAL, contenant les interfaces pour 








par Michel Racine. Toutes explications page 47. 
Finder.Root est un fichier pour le Finder, PRODOS est un faux. | 
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Avertissements légaux 


ToolBox- Mag est un magazine qui 


prend l'Apple 1! GS au sérieux. De ce 


fa fait même, 1 est indépendant d'Apple 


| Computer et. d'Apple : Com 


puter. 
Francs, Era LE nest, Lg dl 


:ciel, Ve 


de ae terpaholg les 
-inséparablement d'une revue sur pa- 


Pier et d'une disquelte magnétique 
‘avertissements légaux, modes d'em- 
ploi, etc, où tous autres textes, peu- 
vent être placés sur la disquette, et 
nécessiter un Apple 11 GS pour être 


lus: ils n'en sont pas moins écrits 


dans ToolBox-Mag, dont ils font par- 
te intégrante. : 


Tout le contenu de la disquette et de 
la revue ToolBox-Mag sont entière- 


ment sous Copyright de la Société. 


ToolBox, et sont déposés à l'Agence 
pour la Protection des Programmes. 
Tous droits de traduction et de repro- 


duction intégralement réservés pour 


tous pays. 

Aucune reproduction, même partielle, 
et sous quelque forme que ce soit, 
de la disquette comme de la revue 
ToolBox-Mag, ou d'un ces pro- 
grammes qu'elles contiennent, ne 
pourra avoir lieu sans accord préa- 
lable et écrit. de ToolBox-Mag. Copier 
ToolBox-Mag, c'est illégal, et cela 
vise à torpiller le seul magazine fran- 
çais sur l'Apple # GS: nous serons 
alors sans pitié. 


*GS" est un sigle déposé par les au- 
tomobiles Citroën. La Pomme est un 
Symbole déposé par Eve et le Ser- 
_pent. Apple, Apple 1! GS, le logo 
‘Apple, Macintosh et le logo Macin- 
Losh, ImageWriter, LaserWriter et 
‘Fatal System Error 911' sont des 
: marques déposées d'Apple Compu- 
ter. AppleWorks-GS est une marque 
déposée par Claris-USA, à l'insu de 
Ctars-France. ToolBox'" et ToolBox- 


MagT* sont des Lo déposées 


de la Société TooiBox 


ToolBox-Mag ne peut pas offrir une 


garantie supérieure à celle qu'offre le 
chapitre “Limitations de Garantie et 
de Responsabilité" des documenta- 
tons officielles Apple, soit quasiment 
rien. Ecrit par des amateurs du GS, i 
s'engage néanmoins à publier des 
programmes ne contenant pas: plus 
de bugs que GS Write, et à maintenir 
dans ses colonnes un standard de 
compétence au moins égal au niveau 
moyen des concessionnaires Apple 
| français en matière de GS. 
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EDITORIAL 


Fort ef vert. 


Rafale de nouveautés, en ce début de printemps, sur notre 
machine préférée: 

+ Un nouveau système, GS/OS 5.04, cette fois-ci disponible si- 
multanément en France et aux USA, grâce à l'un de nos au- 
teurs, Yvan Kænig. 

+ Le magnifique outil MidiSynth et son logiciel SynthLab 
sont désormais en vente libre: vous ne saviez pas encore vrai- 
ment ce que signifie le “S” de “GS”. Bien entendu, Jean-Pierre 
Charpentier commence dès ce numéro à nous montrer com- 
ment on s'en sert. 

+ HyperCard GS est désormais dans le commerce: c'est bien, 
comme le dit A2 Central, l'Applesoft des années 90, la pro- 
grammalion en mode Graphique /5on à la portée de tous. 

e InWords, de WestCode Software, lui aussi commerciale- 
ment disponible, apprend à lire à notre GS (voyez l'étude de 
Bernard Fournier). 

+ Genesys 1.2, de SSSI, enfin, qui écrit à votre place une ap- 
plication complète avec tous ses menus, toutes fenêtres, tous 
ses boutons à cocher, ses boîtes de dialogue, etc: c'est la pro- 
grammation en mode “desktop” à la portée de tous. 


Ce numéro 4 est aussi la preuve vivante d'une des grandes ca- 
ractéristiques du GS: l'inventivité des programmeurs, qui dé- 
coule de leur liberté. Jouez au ‘Fun Beyond GS" du FTA, uti- 
lisez le magnifique GE 80 de Régis Mange (en P8!), écrivez 
dans la bordure de votre écran, mettez tous vos outils en mé- 
moire, dessinez-vous le fond de bureau que vous souhaitez, et 
bien d'autres choses encore: tout cela dans ce numéro 4. 

Cette inventivité a une source: la machine elle-même. “Merci, 
Apple”, écrit Patrick Desnoues en fêtant son entrée à notre 
Conseil de Rédaction. Même quand on en fait un usage im- 
prévu, c'est bien encore elle qui le suscite. 


Reconnaissons-le, tous ces progrès ont un prix: l'usage du GS 
n'est pas ce qu'il y a de plus facile pour le débutant, ni même 
pour l'habitué, qui doit souvent changer d'habitudes. Notre 
magazine essaie d'aider chacun à ces changements. 

Par exemple, chacun de nos programmes comprend une par- 
tie “pour l'utilisateur”: nous avons donc supprimé les éé, 
chaque article étant à plusieurs niveaux. Nous continuons, 
bien sûr, les nouvelles du monde, de France et... du monde 
extérieur. Nous publions patches et conseils d'utilisation. 
Nous démarrons aussi, dans ce numéro même, une série pour 
les débutants. 


La prochaine fois qu'on vous ressortira l'inusable fable de la 
“mort de l'Apple IT”, sortez votre arme: le Bulletin d'abon- 
nement à ToolBox Mag ! 


ERIC WEYLAND 
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a —— "2.0 


a ——— 


cos 504: Île Système 
nouveau est arrivé | 





J.Y. Bourdin 


Grande nouvelle: la dernière version du sys- 
tème de l'Apple II GS, GS/OS 5.04, est dispo- 
nible en France, en version française, en même 
temps qu'aux USA. 


Quand on sait qu'il faut des mois et des mais à 
la bureaucratie Apple pour réaliser une version 
française du système, on devine ce qui se passe: 
cette bureaucratie a été court-circuitée, et quel- 
qu'un a réalisé une version à coups de désas- 
sembleur. Devinez qui? Yvan Kænig, bien sûr! 

Vous trouverez sur la disquette ToolBox Mag 
une note “technique” de notre éminent collabo- 
rateur expliquant ses choix de francisation. Pour 
ma part, je me contenterai de vous expliquer 
pourquoi vous ne pourrez pas vous en passer. 


Car cette nouvelle version du système est indis- 
pensable à tout utilisateur d'Apple II GS: 

° Quantité de bugs, dont certains vraiment gè- 
nants (dans TextEdit et le Resource Manager 
par exemple), ont disparu. 

* Le nouveau driver d'ImageWriter permet une 
impression de listings en mode rapide tout en 
restant en mode graphique: cela signifie que 
vous ne verrez plus dans ToolBox Mag ces lis- 
tings TML Pascal sans accents qu'on trouvait 
dans les premiers numéros. On peut écrire ses 
commentaires normalement sous TML, et on 
imprime les fichiers avec Appleworks-GS ou 
tout autre traitement de textes GS. 

* La francisation du clavier est automatique- 
ment celle d'Yvan Kænig: c'est désormais la co- 
lonne de droite du tableau pages 18/19 de Tool- 
Box Mag, 3 que vous avez par défaut dans votre 
système. J'ai déjà dit la supériorité de la formule 
Kænig sur l'ancienne formule Apple. 

+ Si vous n'avez pas la dernière version du sys- 
tème, vous serez incapable de faire tourner les 
programmes des disquettes ToolBox Mag, 
(comme nombre d'entre vous s'en sont déjà 
aperçus!). Il est absolument exclu que ToolBox 
Mag demande à ses auteurs de régresser dans 
leur usage du GS: ToolBox Mag est incompa- 
tible avec les systèmes GS périmés. 

* Vous ne pourrez pas faire tourner non plus 
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Platinum Paint et HyperCard, qui sont des 
nouveautés logicielles majeures du GS. Bref, le 
5.04 est le système d'aujourd'hui. 


Attention, la bureaucratie Apple étant sur la 
touche, la diffusion du 5.04 est un peu spé- 
ciale: vous risquez de ne guère le trouver pour 
le moment chez les concessionnaires Apple or- 
dinaires, mais seulement chez les commerçants 
qui soutiennent réellement le GS: la liste est 
courte, et vous la connaissez. 

Il ne contiendra aucune documentation spécifi- 
que sur papier (il n'en a pas besoin). Vous aurez 
deux formules pour l'acquérir: 

*si vous n'avez pas le système 5.02 français 
(honte à vous), vous paierez simplement 100 F 
plus cher le système complet. Vous aurez la do- 
cumentation du 5.02, mais les disquettes seront 
celles du 5.04. Vous serez donc enfin à jour. 

+ si vous avez déjà le 5.02 français, il suffira de 
payer 100F (plus port) pour une disquette de 
mise à jour. Voici dans ce cas la procédure à 
suivre: faîtes une copie de vos deux disquettes 
du 5.02. Lancez votre 5.02 actuel, et passez sous 
le Finder. Introduisez la disquette “Mise à jour 
5.04”, et lancez le programme “Installation”. 

Ce programme se chargera de mettre à jour vos 
copies des disquettes système, il suffira de lui 
obéir. A la fin, vos deux disquettes 5.02 seront 
transmuées en système 5.04. Lancez alors le pro- 
gramme Installation de ces nouvelles disquettes 
système, pour installer le 5.04 sur le disque de 
votre choix: la documentation du 5.02 vous dit 
ce qu'il faut savoir à ce sujet. 


C'est un peu compliqué, mais cela vous permet 
de payer le minimum, et d'avoir le nouveau sys- 
tème en même temps que les Américains. 





Une précision enfin: ce système a des bugs, bien : 


sûr, certains sont même déjà officiels. Mais la 
probabilité pour qu'un de ces bugs ait été rajou- 
té à la francisation est infinitésimale. Yvan 
Kœænig n'est pas un des auteurs du 5.04: lisez 
son texte sur la disquette avant de lui trans- 
mettre vos “bug reports”. 
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La communication entre 
logiciels, ou comment 
décorer son bureau 


Patrick Desnoues 


| Si vous communiquez un peu sur Minitel, vous 
| Savez que, quand vous vous connectez sur cer- 


tains serveurs, on commence par vous avertir 
que vous avez du courrier dans votre Boîte aux 
Lettres (BAL). De la même façon, vous pouvez 
laisser un message à quelqu'un: dès qu'il se 
connectera, il sera prévenu. 

Eh bien, il en est de même pour les différentes 


applications du GS: depuis le ToolLocator v2.1, 


il existe une BAL interne au GS, appelée Mes- 
sageCenter, et quand un programme démarre, il 
peut commencer par consulter son courrier. 
Avec le système 5.0, arrive un nouveau lype de 
message. Gageons qu'Apple ne s'arrêtera pas là. 
Sur Mac, ce type d'interface est largement utili- 
sé, il faut que cela le devienne également sur 
GS, l'intégration des applications différentes 
étant réellement un gain pour l'utilisateur. 


: Appleworks-GS et quelques autres le permet- 
tent déjà: alors programmeurs, communiquez, 


d'autant plus que c’est très simple. 


Vous connaissez certainement un premier type 
de message, qui existe depuis un moment: 
quand on clique sur l'icône d’un fichier d’Ap- 


: pleworksGS dans le Finder, on peut lancer l’ap- 


plication par les commandes ‘Ouvrir’ où ‘Impri- 
mer’ du menu ‘Fichier’. 

Une fois l'application lancée , celle-ci teste si elle 
a du ‘courrier’. L'outil MessageCenter (Miscella- 
neous Tool) va se charger de l'informer : 

a) Est-ce qu'il y a un message ? 

b) Si oui, le nom du fichier à traiter est donné. 

c) Que fait-on de ce fichier (ouvrir, imprimer) ? 
Voir l'exemple 1 qui traite de la réception d'un 
message. Pour envoyer un message vers une 
autre application, il suffit de communiquer le 
nom du fichier à traiter, le type de traitement, et 
de suivre l'exemple 2... 


Mais un nouveau type de message est apparu 


avec le système 5.0. Cela m'a donné l'idée 





d'écrire deux petits Inits utilisant ces nouvelles 
propriétés (Joli.Ecran et Joli Motif). 
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oo 


Ce type de message est d'ordre graphique: à 





chaque initialisation du Window Manager, ce- 


lui-ci va aller voir s'il y a des informations pour 


lui. Si oui, au lieu de l'écran bleu standard du : 


bureau, il va afficher une image ou un motif 
de notre choix. 


Les sources complets des deux inits sont donnés 
dans les deux exemples. Exemple 3: Message de 
type Pattern (motif). Exemple 4: Message de 
type Picture (dessin). 


Utilisateurs, copiez dans cet ordre à la fin de 
votre dossier */SYSTEM/SYSTEMSETUP/ les 


trois fichiers suivants de /TOQL.- 
BOX.MAG.Ü4/JOLIBUREAUL.INIT /: 1/ JOLI.MO- 


TIF; 2/ JOLLECRAN: 3/ ECRAN.BUREAU. Désac- 
tivez ensuite (avec le Finder} celui des deux fi- 


chiers inits que vous ne désirez pas voir actif. 


Puis redémarrez. 
Merci Apple, on attend d'autres messages. 


PS : ces exemples utilisent les librairies e16.Locator 
et e16. Window d'AP WiOrca. Les exemples 1 et 2 ne 
sont pas directement réassemblables, ce sont des 


schémas pour vos propres programmes. À vous de : 
les remplir avec vos messages. Pour réassembler les ! 


exemples 3 et 4, veillez à avoir mis le fichier {MA- 
CROS.APWIMI6.A de la disquette ToolBox Mag 4 
en tête de vos fichiers M16.X. 


Trois fois le même ! 


Vous lrouverez pages 8 et 9 de ce numéro 
trois fois le même programme (l'exemple 4 de 
Patrick Desnoués) permettant de charger le! ] 
dessin de votre choix en fond de bureau. 
i 
: 





Il s'agit de montrer comment la même routine 
peut être écrite indifféremment en C, en Pas- 
cal ou en Assembleur. 

Du coup, vous apprendrez aussi comment 
écrire des Inits en C et Pascal, et comment y: 
. mélanger un peu d'assembleur (ce n'était pas 


| si simple que ça en avait l'air...) : 
| JYB ] | 


Page 5 



















































































Exemple 1 : réception d'un message 
MessageCenter par une application 


SRE == — = 














MessageCenter ENTRY 


{Longueur maximum : 4 (MessNext} + 2 (MessType) + 2 {Info} 
+ 15 (NomFichier) + 51 (NomComplet) + 1] 


LongMes £4+2+2+16+52+1 


LongResuit 
Pushlong £LongMes Nombre d'octets à réserver 
Pei <MyID Numéro ramené par _MMStartup 


Pushword #% 1 100000000001000 Atributs mémoire 
PushLong #0 

_NewHandle 

Pulllong HandleMesCenter 


PushWord #GetMessage 
PushWord #fileInfoType 
Pulliong HandieMesCenter 
_MessageCenter 

Bes DispHandMesC Y'a pas de message. 


fef Ebrairie E16 Locator] 


[Y'a un message) 
Lda 3, 

Sta <Handle+2 
Lda 1,5 

Sta <Handie 


Lay #2 

La [Handle],Y 
Tax 

Lda [Handle] 


Stx <Handle+2 
Sta <Handle 


Läy #HomessageDala 
Lda [Handle],Y 
Cmp £2 

Bcs DeleteMessage 
Sta TypeMessage 


{Le Message a le format suivant: 
MessNext Long Utilisé par MessageCenter 
MessType Word = 1: Signifie une info concernant 
un fichier 
Block --> 
Word 


Adresse du message 


Quel est le type de message? 


Les messages à traiter sont = ou I 
Pas connu. pas traité... 


MessData 
= 0 : ouverture de ce fichier 
= À : Impression de ce fichier 
Str NomFichier" 

Str 'NomFichier Complet 

Bite 0] 


{Ajuste le nom du fichier en GSString (Longueur du nom sur 2 
octets). Exemple: 
OT 294 86078 AD CF 
D'OR AS ae PEN OS 2 Ie Le Ve TE 
Valeur = (4+2) + 1; octet longueur = 7] 
Ldy £7 
Lda [Handie],Y 
Xba 
Sta [Handle],Y 


{[Caicule l'adresse du nom du fichier] 
Läx <Handle+2 Pointeur du nom 
Lda <Hanille 
Ck 
Adc #7 +7 octets pour début du nom 


{Les registres X et À contiennent un pointeur sur le nom du fi- 
chier] 
Jsr LordFichier 
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{Maintenant on teste s'il faut imprimer ce texte} 


ESS = 


Lada TypeMessage 
Beg DelcteMessage 


{On va imprimer le fichier] 
Jsr Imprimer 


{On a iu notre courrier, on peut maintenant le jeter] 


DeleteMessage Anop 
Push Word #DeleteMessage 
Push Word #filelnfoType 
PushLong #0 
_MessageCenter 


{On Bbère la mémoire uiilisée par le message 
DispHandMesC Anop 
Pushlong HandleMesCenter 
_DisposcHandle 


Suite du programme 
HandleMesCenter ds 4 
TypeMessage ds? 


LoadFichier Anop (ce passage est une esquisse) 
_OpenGS ParamOpen 


_NewHandle TailleFichier 
_ReaëGS ParamRead 
_CloseGS ParamClose 


fouverture d'une fenêtre 
et passage en TextEdit} 


Jsr NewWindow 





Ris 
Imprimer Anop (ce passage est une esquisse) 
_PrSuDialog Option de mise en page 
_ProbDialog Options : qualité ! Nombre de pages etc. 
_PrOpenDoc Préparation impression 
_PrOpenPage Préparation de la page 
_TEPaintText Dessine le texte dans la page à imprimer 
_PrClosePage 
{sé plusieurs pages goto _ PrOpenPage] 
_PrCloseDoc Préparation terminée 
_PPicFile Imprime les pages préparées 
Ris 


Exemple 2 : envoi d'un message 
MessageCenter à une autre application 


== En RSS SSII ENS SES LT RSS 
LongResult 
Pushlong £LongMes Nombre d'octets à réserver 


Pei <MyID Numére ramené par _MMStartup 
Pushword 4% 1100000000001000  Atributs mémoire 
PushLong #0 

_NewHanaile 

Pulllong HandleMesCenter 


Pushlong £PainiMesCent 
Pushlong HandleMesCenter 
PushLong £LongMes 
_PirTokand 


PushWord #AddMessage {ef librairie E16 Loraror) 

Push Word #fielnfoType 

Pulllong HandieMesCenter (Zone mémoire pour 
noire messape) 

_MessageCenter 
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PointMesCent Anop 
Utilisé par MessageCenter 





Exemple 3 : envoi d'un message 


de type Pattern (motif) 
init Joli. Motif v1.0 





65816 On 
START 
{Variables Page Directe] 


Handle  GequS00 dsé 
HandleB Gequ SH ds4 


MyID 


MainProgram 


Pointeur 
Handle 


Gequ S00 ds2 
{[Prograrame] 


{Voir commentaire dans l'exemple 4.] 


Php>>> Sauvegarde le registre P 
Phb>>>> Sauvegarde le registre B 
Phk Le Registre B = Registre K 
Plb 
Long mi Registre en mode 16 Bits 
Tax Myld 

Ê Ldn 40 

L LongResull Pattern = 32 octets 
Push Word Paramétres Message Center = & 
PushWord #8+32 
Phx Myld 
Pushword #% 100000000000 1000 
PushLong 
_NewHandle 
Pullax HandlePattern 


{Copie notre message vers le Handle pour le Window Manager] 


PushLong #MyMessage 
Pushxa 

PushLong #32+8 
_HandToPtr 


[MessageCenter] 
{Voir commentaire dans l'exemple 4] 


odMessageType  Equ 2 
odTypePattern Equ 0 


PushWord #AddMessage 
PushWord #odMessageType 
PushLong HandlePattern 
_MessageCenter 


PushLong HandlePattern 
_DisposeHandie 


EndNice Anop 
Pb Restaure le registre B 


Plp Restaure le registre P 
Rtl 


HandlePattern ds 4 
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MessNezt ds 4 
MessType dew 1 = 7 :Signifie une infe concernant 
un fichier 

MessData de.w 1 mpression du fichier 

Str'MonFichier' 

Str'*/MonFichier' 

Byte 0 
ESS FSSSSSSSSESSESE EEE mennene méme mens 





Noir 
BleuMarine 
VertBout 
VertGris 
Rouge 
Mauve 
Orange 
Rose 

Vert 
VertFonce 
VertClair 
VertTClaur 
Gris 

Bleu 
Jaune 
Blanc 





[Couleur Mode 6440] 


Equ $D 
Equ $E 
Equ $F 


[installe le message avec Les paraniètres nécessaires: 


SIX) : odmkReserved 


: Utilisé par Message Center 


04 : admMessagetype : 80002 


F06 : odmDrawTvpe 


: $0000 : Pattern 


$08 : odmDraw Data  : 820 octets pour le pattern] 


MyMessage 
MesNext 
MesType 
DrawType 


MyPattem 


MaskPattern 


Anop 

ds 4 

de,.w odMessageType 
de.w odTypePattern 


Anop 

de.B Rouge*S10+Bleu,Rouge*S10+Bleu 
de.B Jaunc*$[04Gris Jaune*$ 104Gris 
dc.B Rouge*$10+Bleu,Rouge*S104Bleu 
dc.B Jaune*$10+Gris Jaune*$10+Gris 
dc.B Rouge*$10+Bleu,Rouge*S10+Bleu 
dc.B Jaune*$10+Gris Jaune*$10+Gris 
de.B Rouge*$10+Bleu,Rouge*S10+Bleu 
de.B Jaune*$104+Gris Jaune*$104+Grs 


Anop 

dc.B &11111111,%11111111 
de.B &11111111,%11111111 
de.B &11111111,%11111111 
de.B &11111111,%11111111 
de.B &11111111,%11111111 
de.B &11LL1111,S11ILIIN 
de.B &11111111,%11111111 
de.B &11111111,#11111111 


[Un pattern se compose d'un petit carré de 8*8 pixels. En 
mode 649 chaque pixel est codé sur 2 bits, offrant donc 4 pos- 
sibilités : (00 } O1 ! 10! 11}. Le mélange de 2 points côte à côte 
permettra d'obtenir d'autres couleurs (16) par “dithering" .] 


END 







La société qui diffuse la carte deË 
digitalisation vidéo DGA-1 (voir article E 
de Jacques Liautard dans ToolBox 
Mag 3) nous prie de préciser que Ë 
cette carte n'est pas compatible Ë 
avec les GS Roms 03, et qu'il n'y a pas À 
de suivi matériel et logiciel de cette £ 


DGA-1 
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Exemple 4 : envoi d'un message 





de type Picture (dessin) 
init Joli.Ecran v1.0 en assembleur Orca 

65816 On 
MainProgram START 

Using Datas 

{Variables Page directe] 
Handle  GequS00 ds4  Pointeur 
HandleB GequS$04 ds4  Handie 
My1D Gegu $00 ds2 
(Programme) 


{A l'arrivée dans un Init, le Registre À contient un numéro 
d'identificateur dispensant d'utiliser ‘MemoryStartup" ou ‘Get 
Newld'. Le fichier sera un TIF {temporaire Init - Type $B7). En 
effet une fois le code exécuté, l'init peut être effacé de la mé- 
maire, la commande Message Center que le Window Manager 
appellera à chaque Startup référençant uniquement un Handie 
sur la zone de l'image en mémoire, (Merci à FUhrick).} 


Php>>> Sauvegarde le registre P 
Phb>>>> Sauvegarde le registre 
Phk Le Registre B = Registre K 
PIB 
Long mi Registre en made 16 Bits 
PushLong <HandleB Sauvegarde les variables 
PushLong <Handle de la Page Directe 
Sta <Myld 

{Initialisation] 
_OpenGS OPPanms Ouvre l'image ‘EcranBuréau 
Jes EndNice Pas d'image -> quit 
Ldx Op_Filetype Est-ce ine image écran ? fixpe SCI) 
Cpx #SC1 
Bne CloseFile Non -> ne rien faire 
Lax Op_Re[Num Paramètres pour les commandes 
Six Re_NumkRel ReadGS 
Stx CI_NumRel CloseGS 


| Une image écran contient S8006 octets. Les paramètres pour 
Message Center demandent $8 octeis. On réserve donc S8008 
octets] 


Lada 40 

Longkesult 
PushWord 
PushW'ord #$8000+8 
Pushword <MyTD 
Pushword #5%100000000000 1 00€) 
PuskLong 
_NewHanäle 
Pullax 

Bes CloseFile 


Stx <HandleB+2 
Sta <HandleB 


Lady: #2 

Léa [HandieB],Y 
Sta <Hanclle+2 
Sta Re_Buffers2 


Léa [HandleB] 
Sta <Handle 
Ck 

Adc #8 


Image = S800û 
Paramètres Message Center = 8 


Problème de mémoire 


Handle de l'image 


Handie -> Peunteur 


8 octets après paramétres de 
MessageCenter 
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Sta Re_Buffer Adresse de l'image pour ReadGS 


_ReadGS ReParms Chargement de l'image 

Bes CloscFile Problème à la lecture 
[installe le message avec les paramètres nécessaires: 
$00 : odmReserved : Utilisé par Message Center 
SOA : odmMessage type  : S0002 
S06 : odmDrawType : SO901 : Picture information 
$GS : odmDrawData : $8000 octets de l'image] 
odMessageType  Equ2 
DrawTypePict Equ 1 

Ldy #odmMessageType 


Lda todMessageType Paramètre pour MessageCenter 
Sta [Handle].Y 


Iloy 

Jay +2 

Lda #HDrawTypePict Paramètre pour MessageCenter 
Sta [Hanéle],Y 





IMessageCenter] 


(Message Center sera lu à chaque Startup du window mana- 
ger, qui au leu de constituer un pattern bleu comme habituel 
lement. fixere votre image sur l'écran, Voici la commande qui 
fait ions le travail... 








À 
Push Word #AddMessage 
Push Word todMessageType 
PushLong <HandieB 
_MessageCenter 
PushLong <HarndleB  Libère la mémoire utilisée 
_DisposeHundle 
ClasePile Anop 
_CloseGS CiParms Fermeture du fichier 
EngNice Anop 
PullLong <Handle Restaure les variabies 
PullLong <HandleB de la page directe 
PIb <<<< Restaure le registre B 
Plp <<< Restaure le registre P 
Ru 
END 
Datas DATA 
{Paramètres OpenFile] 
OPParms de.W 6 
Op_RefNum ds2 
Op_Pathname de.L ImageToload 
Op_Reg_Access de. W0 
Op_ResourceNem de. WO  :@:datat 1: Fark 
Op_access ds 2 
Op_Filetype ds 2 
ImageToLoad GsSuing */System/Sysiem.Set- 
Up/Ecran.Burcatr 
{Paramètres ReaaF ile] 
ReParms de.W 4 
Re_NurmkRet ds 2 
Re_Buffer ts 4 
Re_Eof dc.L S8(OG+S 
Re_OxctTrans ds 4 
{Paramètres CloseFile] 
ClPanns de. W | 
CLNumkRef ds2 
END 
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init JOLI.ECRAN en Orca/C init JOLIECRAN en Orca/Pascal | 


Francois Uhrich 







(voir commentaires et version développée 
dans le source sur la disquette} 














#pragma optimize -1 
{es includes nécessaires] 
#include <types.h> 
#include <memory.h> 
#include <locator.h> 
#include <gsos.h>, 
#include <orcah> 









{La structure du message nécessaire à MessageCenter] 
typedef struct DeskMessage { 

long reserved; 

word messageType: 

word drawType; 

char drawData[32000!: 
} DeskMessage,* DeskMessagePtr **DeskMessageHndl: 


: void main() 
! 


Î 
DeskMessageHndi mess; 
OpenRecGS openparam; 
| 





IORecGS readparam = [ 4,0, NIL, 32000L, OL, 0 }; 
RefNumRecGS closeparam = { 1 ,0 }; 

GSString255 ecran = { 34."*/SYSTEM/SY STEM.SET- 
UP/ECRAN.BUREAU" }: 

{Ouverture de l'image ECRAN BUREAU] 
openparam.pCount = 6; 

openparam.pathname = &ecran:; 
openparam.requestAccess = readEnable: i 
openparam.resourceNumber = 0: 
OpenGS(&openparam)}; 

if {toolerror(}} return; 

rcadparam,.reÎNum = closeparam.refNum = openpa- 
ram.refNum; 


{L'image est-elle bien de type $C1 ?] 
if (openparam.fileType==0x00C1} { 
[Allocation d'un handle de 32008 
octets pour le message] 
mess = {DeskMessageHndl) NewHandle{(long}size- 
of(DeskMessage).userid(),0x8018,0L): 


if (ltoolerror(}} { 
{Lecture des 32000 octets de l'image dans le handle] 
rcadparam.dataBuffer = (*mess)->drawData: 
ReadGS(&readparam): 
[Envoi du message au tool lacatar ] 
(*mess)->messageType = 2: 
(*mess)->drawType = 1; 
MessageCenter(addMessage.2 mess); 
} 
} 
{Fermeture du fichier image] 
CloseGS(&cioseparam}: 






| 
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Bernard Fournier 









{voir commentaires dans 
le source sur la disquette) 





1$keep ‘JoliEcran'} 
{$optumize -1} 


PROGRAM JoliEcran; 
uses Common, ToolLocator, Memory Mer, |} 
MscToolSet,GSOS: : 

| 


Label 100; 


Const noError =0: 
chune =2, 
Type 
MyMessageHndl = "MyMessagePtr, 
MyMessagePir  =MyMessage: 
MyMessage  — record 
MReserved: LongInl; 
MType : Integer; 
MDraw : Integer; 
MData : packed array [1..32000} of byte; 
end; 


VAR 
MyMemory[D  : inteyer; 
CustomScreen : MyMessageHndl; 
OpenName  : gsosinSting; 
FileOpen  : openOSDCB; 
FileRcad  : reaWnteOSDCB; 
FileClose  : closeOSDCB; 
begin 
MyMemorylD:= MMStartlp: 
if ToolError = noError then 
begin 
CustomScreen:=MyMessagelIndi{NewHandle(32008, 
MyMemory!D,attrLocked,nil}}; 
with CustomScreen"** do begin 
MReserved :={); 
| 
î 
| 


with OpenName do begin 
theString:="*/System/System.SetÜp/Ecran.Bureau'; 
size:=length(OpenName.theString); 
end; 
FileOpen.pcount:=6; 
FileOpen.pathname:=ponter(@OpenN ame): 
FileOpen.requestAccess:=0; | 
FileOpen.resourceNumber:=0; 
OpenGS(FileOpen}; a: 
if ToolError<>Nobrror then goto 100; | | 
if FileOpen fleType<>$Cl then goto 100: | 
FileRead.peount:=4; 
FileRead.refnum:-FileOpen.refnum; 
FileRead.databuffer:=@CustomScereen# MData; 
FileRead.requestcount:=32000: 
ReadGS(FileRead}: 
1f ToolError<>NoError then goto 1; 
MessugeCenter(l.2.Handle(CustomScreen)} 
end; 
100: 
FileClose pcount:=l; 
| FileClase.refnum:=FileQpen.refaum:; 
CleseGS(FileClose); 


DisposeHandle(handle{CustomScreen)); 
end. 
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écrire des Inits en C 


François Uhrich 


Les puristes vont hurler mais aujourd'hui il y a 
un peu d'Assembleur au menu! C'est qu'il s'agit 
de demander au compilateur € de faire un type 
de programme qu'il n'a pas prévu: un Init. 


Qu'est-ce qu'un Init ? 


Les Inits de l'Apple Ilgs sont des programmes 
situés dans le répertoire */SYSTEM/SYS- 
TEMSETUP. Ces programmes sont exécutés 
pendant le boot après le chargement de GS/0S 
et des drivers, mais avant les accessoires de 
bureau (NDA et CDA). Il y a deux types d'Inits: 
* les Inits permanentes (fichier de type $B6 ou 
PIF) qui sont chargées, exécutées et qui restent 
en mémoire. Cela peut être le cas par exemple 
d'Inits patchant les tools, de l'affichage d'une 
horloge dans la barre de menu. 

+ les Inits temporaires (fichier de type SB7 ou 
TIF) qui sont chargées, exécutées puis purgées 
de la mémoire. Ces Inits ont une opération à ef- 
fectuer et après cela leur présence est inutile: 
l'affichage d'une image ou le déclenchement 
d'un son au boot sont des exemples d'Inits tem- 
poraires. 


Quelle(s) différence(s) y at-il entre un pro- 
gramme "classique" (de type 516) et une Init 
(temporaire ou permanente)? Réponse: "pres- 
que” aucune ! 

Comme tout autre programme sur G$, une Init 
peut utiliser les tools du système, utiliser 
GS/O0S... etc. Un détail à souligner: les acces- 
soires de bureau sont absents au moment de 
l'exécution d'une Init. 

La seule différence, mais elle est capitale, c'est 
qu'un programme 516 se termine par un appel 
au Quit de GS/O$, alors qu'une Init doit se ter- 
miner par un simple retour long de sous-pro- 
gramme: RTL. 

Nous allons voir comment réaliser des Inits 
avec Orca/C et APWC. 


Les Objets de la Compilation Orca/C 


Une fois un programme source Orca/C compi- 
lé, deux fichiers de type OBJ sont créés: 

Xxx.root et xxx.a (xxx étant le nom de votre 
programme). 
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xxxa contient la compilation de votre pro- 
gramme source, alors que xxx.root est un fichier 
standard créé automatiquement par le compila- 
teur. 

Il y a trois versions différentes de xxx.ro0f sui- 
vant qu'il s'agit d'un programme classique 516 
ou EXE, d'un NDA (commande pré-processeur 
#vragina NDA) ou enfin d'un CDA (commande 
pré-processeur #yragma CDA). Dans le cas d'un 
accessoire de bureau, xxx.root contient en fait 
l'en-tête nécessaire à un NDA ou à un CDA. 
Comme il nous manque un #pragmu INIT, nous 
devrons nous rabattre sur le xxx.roof classique: 
case on 

Start 

pea $2000 

js! + BWSTARTUP 

pea -GLOBALS;-8 

pib 

plb 

js! -C_STARTUP 

JS mair 

Jsl -C_SHUTDOWN 

end 


—_BWSTARTUP est une fonction de la librairie 
SYSLIB qui initialise l'environnement C ainsi 
que l'espace nécessaire à la pile (pea 52000 pour 
réserver 8Ko de pile) et enfin l'ouverture de 
SANE (outil de calcul arithmétique). 

—C, STARTUP (librairie ORCALIB) s'occupe es- 
sentiellement de la lecture de la ligne de com- 
mande éventuelle à passer en argument argc et 
argv au main{) (voir C Facile Toolbox Mag n°2). 
La fonction principale main() de votre pro- 
gramme est enfin exécutée. 

-C_SHUTDOWN (librairie ORCALIB) termine 
l'exécution en purgeant la mémoire allouée 
pour la pile et par le programme, et enfin ap- 
pelle la fonction -QUIT qui exécutera le QUIT 
de GS/OS: 


GSOS 
-QUIT 


= ROOT 


gegu SEIOUAS 

Entry 

pha 

jt -MMINIT 
PusäWord >-USER_ID 
_DisposeAll 

pla 

jsi >GSOS 
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dc i2'$0029 Quit 

dc i4'-QUITPARAM" 
—QUITPARAM anop 

dc i4'0' 

dc i2'0° 

end 
Comme l'a très bien décrit Mike Westerfield (de 
Byte Works Inc. en fait l'auteur d'Orca Pascal et 
Orca ©) dans son article concernant les inits en 
Orca/C ou Orca/Pascal dans le numéro d'avril 
1990 de l'excellent magazine 8/16, il ne suffit 
pas de supprimer le QUIT GS/OS de -QUIT. 
En effet il y a problème avec la pile. Lorsque 
GS/OS reçoit un QUIT, peu importe l'état de la 
pile, le programme courant est abandonné pour 
passer le contrôle à un autre. En revanche avec 
un RTL, il faut que la pile soit impeccable! Or, 
dans un programme en C, l'instruction exitf) 
permet de quitter un programme à partir d'un 
sous-programme quelconque et Orca/C dans ce 
cas ne maintient pas sa pile en bon état. La solu- 
tion de Mike Westerfield est donc de stocker la 
position de la pile à l'arrivée dans -_ ROOT et 
de restaurer cette position dans -QUIT avant 
un simple RTL. 
Voici le -_ROOT pour les Inits: 


case on 
— ROOT start 

tax 

{sc 

sta >-QUITSTACK 

{xa 

pea $2000 

jsl — BWSTARTUP 

pea -GLOBALS!/-8 

pib 

pib 

js -C _STARTUP 

jsl main 

jst -C_SHUTDOWN 

end 


C'est -QUITSTACK qui contiendra la position 
de la pile. 

A noter une importante modification par rapport 
à la version de Mike Westerfield: à l'arrivée 
dans -_BWSTARTUP, le registre À ne doit pas 
avoir été modifié car le loader a la bonne idée 
d'y avoir stocké l'identificateur mémoire du 
programme et cela également dans le cas des In- 
its (voir les File Type Notes $B6 et $B7 d'Apple). 
—_BWSTARTUP commence donc par stocker A 
(après toutefois un ora $0100) dans la variable 
-USER_ID qui sera notamment utilisée par la 








ainsi: 
typedef struct DeskMessage { 
long reserved; 
word messageType; 
word  drawType; 
char  drawData[32000]; 


données comme n'importe quels autres types: 
DeskMessage message; f* structure *j 
DeskMessagePtr messagePtr; 
DeskMessageHndl messageHndl; 


message.messageType = 2; 
messagePtr->drawType = 1; 
(*messageHnädl)->drawDatal0]=0; 


ou d'une variable quelconque. Ainsi: 
sizeof(int) vaut 2. 

sizeof(long) vaut 4. 

sizeof(char) vaut 1. 






sizeof(message) vaut également 32008. 


ToolBox Mag n° 4 


Les Structures de Données en C 


Dans le source de Joli.Ecran, la structure du message contenant l'image du bureau est définie 


} DeskMessage “ DeskMessagePtr,**DeskMessageHndl; 


Après cette déclaration de type, le programmeur peut librement utiliser ces nouveaux types de 


{* pointeur sur structure *! 
!* handle (pointeur de pointeur) sur structure */ 


Pour accéder à partir de ces variables à chacun des différents champs de la structure, il faut utili- 
ser le point ”." ou bien ‘->' dans le cas d'un pointeur sur la structure: 


La macro instruction sizeof du pré-processeur C permet de connaître la taille en octets d'un type 


sizeof(DeskMessage) vaut 4+2+2+32000=32008 octets. 


mais sizeof(messagePtr) et sizeof(messageHndl) ne valent que 4, puisque ce sont des adresses. 
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fonction userid() de la librairie ainsi que pour 
un DisposeAll final. Le registre À a donc tout in- 
térêt à être valide. Voilà la raison du fax et du 
txa dans -_ROOT. 

La fonction -QUIT (segment -_BWCommon de 
la librairie SYSLIB) devient alors: 


—QUIT entry 

pha 

js -MMINIT 

PushWord >-USER ID 

_DisposeAll 

pix 

ida 

{cs 

{xa 

rt 

-QUITSTACK entry 
See 


>-QUITSTACK 


Sur la disquette vous trouverez donc Cinit.roof 
et Common.root. Voici les opérations à effectuer 
afin d'obtenir votre Init que je nomme Monl- 
Hil.cc: 

* compilation: 

compile Moninit.cc keep=$ 

+ remplacement de Monlnit.root par la version 
modifiée Cinit.root: 

copy -c Cinit.root Monlnit.root 

»* édition de liens en plaçant Common (conte- 
nant le nouveau -QUIT) avant la librairie : 

link Monlnit Common 2/orcalib 2/syslib keep=Mo- 


ninis 
Les Objets de la Compilation APWC 


Avec APWC il y a quelques différences. 

Tout d'abord, il n'y a qu'un seul fichier OBJ 

xxx.root issu de la compilation. [1 correspond 

donc au xxxa de Orca/C. C'est au moment de 

l'édition de liens qu'un en-tête est ajouté: 

link 2/start MonProg 2/clib keep=MonProg 

Le start.root situé dans le répertoire des librai- 

ries correspond au xxx.r00t de Orca/C et effec- 

tue à peu près les mêmes opérations d'initialisa- 

tion et de fermeture. Le quit GS/OS est réalisé 

par la fonction CQuit de la librairie CLIB appe- 

lée par start.root: 

GSOS gequ $SEIXIAS 

CQuit start 
da 
sta 
tda 
sta 
da 
jst 
de 
dc 
rtl 
end 

Avec APWE, la position de la pile ne pose au- 


2 


$04,5 

S0O014 

$06,s 
S0014+$9002 
508,5 
>GSOS 
i2"$0029" 
4806000000" 


Quir 


cun problème (visiblement sfart.root a été écrit 
en € comme le démontre le RTL après le QUIT 
GS/O58..), par conséquent la solution la plus 
simple sans modifier sfart.root (ce qui pourtant 
permettrait de gagner pas mal d'octets en 
APWC... avis aux amateurs !) est de linker une 
fonction CQuit “vide! avant la librairie CLIB: 
CQuit start 

rti 

end 
Sur Ja disquette, vous trouverez donc 
CQuit.root. Voici les opérations à effectuer afin 
d'obtenir votre Init que je nomme Monlmif.cc 
écrite cette fois-ci avec APWC: 
+ compilation: 
compile Monlnit.cc keep=$ 
+ édition de liens en plaçant CQuit avant la li- 
brairie CLIB: 
link 2istart Monlnit CQuit 2/CLib keep=Moninit 


Un exemple: Joli. Ecran en C 


Vous trouverez sur la disquette le source C 
{comme d'habitude à la fois pour Orca/C et 
APWC) de l'Init Joli.Ecran (Nice.Screen) que Pa- 
trick Desnoues vous présente en Assembleur 
dans ce numéro. 

Attention, le source de Joli.Ecran en Orca/C 
imprimé page 9 de ce numéro est une version 
abrégée pour permettre la comparaison avec la 
version en Assembleur et en Pascal. Pour avoir 
le source complet, avec les commentaires et une 
version pour APW/C, imprimez le fichier- 
source de la disquette. 


La version APWC occupe après édition de liens 
11 blocs, alors que Orca/C n'occupe que 5 blocs 
(ExpressLoad inclus dans les deux cas). Si je 
n'avais pas ulilisé des appels directs à GS5/05S 
pour l'ouverture (OpenGS)}, la lecture (ReadGS) 
et la fermeture (CloseGS) du fichier d'image, 
mais plutôt des appels à la librairie standard C 
(stdio.h avec fopen, fread et fclose) l'occupation 


sur disque aurait au moins doublé... La puis- 


sance de la librairie standard C d'entrée-sortie 
ne devient intéressante que dans le cas de traite- 
ment complexe de fichiers mais certainement 
pas pour la simple ouverture, lecture, fermeture 
d'un unique fichier. 


A noter: pour gagner de la place sur le disque, 
on pourrait modifier Joli.Ecran pour qu'il charge 
aussi une image compactée de type $C0 (un 
fichier-écran $C1 fait 32Ko {NDLR: mais pas 
forcément 65 blocs, voyez la disquette.….). 


8/16 Central: P.O. Box 11250 
Overland Park, KS 66207, USA 
Abonnement un an (12 disquettes): 569. 
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L'Init “Joli. Ecran” de Patrick Desnoues se ré- 
sume à un appel à GS/OS et un appel à la Tool- 
Box (MessageCenter). Le traduire en Pascal, ap- 
paremment, rien de plus facile. Et pourtant. 


Un Init en Pascal, est-ce possible ? 


En Pascal, le compilateur et l'éditeur de liens 
ajoutent en début de programme un code ser- 
vant à initialiser certains paramètres (position- 
ner le registre de pile, de banc, réserver la mé- 
moire pour les variables...) et à la fin un code 
permettant de revenir au programme ayant ap- 
pelé l'application (libérer la mémoire réservée et 
effectuer un QUIT GS0OS). 

Ces lignes de code sont ajoutées automatique- 
ment à toute application, et nous sommes obli- 
gés de passer par là, puisque, s'il existe des di- 
rectives spéciales de compilation pour les ND'A 
et les CDA, il n'en existe pas pour les Inits. 

Mais un Init n'est pas une application: lorsqu'il 
est exécuté, il doit rendre la main au Loader qui 
continuera le chargement du système d'exploi- 
tation (par un RTL). Or, le code standard généré 
par le compilateur effectue un QUIT_GSOS. 


Il faut donc intervenir dans le processus de 
compilation pour le modifier. Conséquence: 
tout ce qui va suivre ne peut concerner que 
ORCA/Pascal et non TML. Comme TML ne 
permet pas d'intervenir dans le processus de 
compilation/linkage, il ne permet pas de pro- 
grammer des Inits. 


Le compilateur Orca/Pascal génère deux fi- 
chiers objets: le fichier .4 contenant le code 
compilé proprement dit, et le fichier .ROOT 
contenant les initialisations de début et fin ainsi 
que le QUIT_GSOS. L'éditeur de liens va en- 
suite lier ces deux modules pour constituer l'ap- 
plication. Pour un Init, l'idée principale consiste 
à compiler notre propre fichier .ROOT, ensuite 
on lie avec COMMON.ROCOT et le tour est joué! 


Comment procéder ? 


La méthode à suivre, avec les explications com- 
plètes, a été publiée dans la revue Américaine 
8/16 du mois de Mai 1990 par Mike Wester- 
field. 

Note: sur la disquette ToolBox Mag 4 se trou- 
vent les sources et macros de COMMON.ASM 





Ecrire des inits en Pascal 


Bernard Fournier 


et PASINIT.ASM ainsi que leurs codes objets 
COMMON.ROOT et PASINIT.ROOT. Les deux 
sources .ASM sont particuliers à ORCA/Pascal; 
ceux relatifs à ORCA/C diffèrent notablement. 
J'ai inclus la correction de François Uhrich au 
bug du source de Mike Westerfield (voir C Fa- 
cile 4 dans ce numéro). 


Méthode à suivre 


+ générer les macros à partir du fichier COM- 
MON.ASM -> COMMON.MAC. 

+ compiler COMMON.ASM -> COM- 
MON.ROOT. 

+ compiler le noyau PASINIT.ASM -> PASI- 
NIT.ROOT. 

+ compiler le source de l'init INIT.PAS -> IN- 
IT.ROOT et INIT.A. 

+ remplacer le noyau standard INIT.ROOT par 
notre noyau personnalisé PASINIT-ROOT. 

+ linker le total: l'éditeur de liens va alors utili- 
ser les routines de INIT.A ainsi que COM-. 
MON.ROOT et INIT.ROOT(qui en fait est la 
copie de PASINIT.ROOT) pour effectuer l'ini- : 
tialisation et le quit (un RTL) de notre Init. | 


Avec cette méthode, vous pourrez compiler 
n'importe quel Init de votre cru en Orca/Pascal, 
pourvu que vous utilisiez bien COMMON et 
PASINIT tels qu'ils sont fournis sur la disquette 
ToolBox Mag 4, et que vous respectiez le pro- 
cessus de compilation/substitution/linkage tel 
qu'indiqué dans le script MAKINIT. 


Remarque: 

Dans ToolBox Mag 2, François Uhrich parlait 
d'un utilitaire MAKE permettant d'effectuer des 
processus conditionnels liés aux dates de mise à 
jour des fichiers sources. J'ai repris cette mé- 
thode dans le script MAKEFILE. Ceux qui pos- 
sèdent cet utilitaire utiliseront donc MAKE- 
FILE, alors que ceux qui n'ont que les utilitaires 
ORCA standard devront lancer le script MAKI- 
NIT. 

Bien évidemment, chacun devra adapter les pré- 
fixes utilisés pour les accès aux librairies assem- 
bleur. 

Ceux qui n'ont pas l'assembleur ORCA devront 
utiliser le script MAKPAS qui emploie les mo- ! 
dules objets et non les sources des routines as- 
sembleur. 






Multimédia : l'explosion 


Le multimédia est en pleine ébullition ces temps-ci. Ma- 
croMind, qui diffuse le meilleur produit multi-média (Di- 
rector}, a annoncé sa volonté de produire une version qui 
permettrait aux possesseurs d'OS/2 de rejouer des anima- 
tions créées avec Director. Jusqu'à présent, les présenta- 
tions réalisées par ce programme ne pouvaient tourner que 
sur un PC sous Windows 3.0 ou sur un Mac, La société 
compterait proposer des versions pour Amiga el pour des 
plates-formes UNIX (Bonjour, Steve !}. 

A cûté des applications sur micro-ordinateurs, MacroMind 
Director, HyperCard 2.0 ou... TooliBox (non, l'autre, le lo- 
giciel qui tourne sur PC}, les solutions spécifiques mon- 
trent le bout de leur nez. 

Le CD-Interactif, développé par Philips et Sony. devrait 
être lancé dans le grand public en septembre prochain. 
Après avoir connu une période de retrait volontaire de 
1987 à 89 (avant cette date, le CD-I ne pouvait animer une 
image que sur 1/4 de l'écran, alors que son concurrent le 
DVI était en ‘Full motion‘), Philips repart à l'attaque. Mo- 
torola à produit pour le CD-T une puce intégrée VLSI per- 
mettant des ammations plein écran. Matsushila, un des 
plus gros géants de l'électronique japonais, s'est allié au 
consortium Philips/Sony en Mai 1989. 

Techniquement, le CD-1 gère quatre niveaux de compres- 
sions sonores autorisant des qualités et des durées plus ou 
moins importantes (d'une heure en qualité CD, à plus de 
neuf heures et demie, avec un taux de compression élevé, 
mais une qualité juste bonne pour de la voix}. En matière 
de vidéo, la couleur est codée sur 5 bits par pixel, avec une 
palette de couleurs de 32000 teintes. Chaque CD:-1 
contient 650 Mégas de données. 

Le lecteur grand public (CDI 602) contient un lecteur de 
CD-I, compatible CD audio, et un lecteur de disquettes 
3,5. Il est pourvu d'1 Mo de RAM et de 8 Ko de RAM 
non-volatile. Il gère les standards TV NTSC et PAL, et 
contient deux slots d'extensions. On peut adjoindre à ce 
système une unité de contrôle multimédia {pour gérer 
d'autres sources tels qu'un un lecteur CD-Vidéo...). 

Des kits de développement sont disponibles pour Mac, PC 
et stations de travail Sun. Les premiers logiciels dispo- 
nibles sont soit des encyclopédies (Encyclopédie Grolier, 
Banque de photographies de Time-Life, Le monde à tra- 
vers les timbres...}, soit des applications pour tout petits 
{Une visite rue Sésame, le Livre des coloriages...), sait 
enfin des jeux (Dark Castle en 3-D, Wings, Déjà vu.…..). 
De l'autre côté, l'éternel rival de Motorola, Intel, qui a in- 
vesti 400 Millions de dollars (2 400 Millions de francs en- 
viron)} en R & D en 1990, prépare depuis plusieurs années 
le DVI (Digital Video Interactive). La solution de cette 
société est un peu différente, Constructeur de circuits inté- 
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Des nouvelles du 
monde extérieur 


par François Hermellin 


grés, Intel se contente de proposer aux constructeurs de 
micro-ordinalcurs des puces à uuliser au sein de leurs ma- 
chines. 

Le 1750 comprend deux composants : le processeur de 
pixels 82750 PB «1 le processeur d'affichage 82750 DB. 
Le processeur de pixels s’'interface à la Ram vidéo pour 
compresser, stocker et rechercher les données. Il permet 
des animations de qualité en compressant et décompres- 
sant chaque trame d'informations en moins de temps qu'il 
ne faut pour F'afficher. Le processeur d'affichage affiche 
les images dans les formats VGA, NTSC, PAL/SECAM, 
et génère Les signaux de synchronisation et de commandes 
d'écrans. Le coût de ces circuits est de l'ordre de 400 F 
pièce. Une machine intègre déjà ces circuits : il s'agit du 
Cornucopia. 

Enfin, Commodore, avec des moyens largement plus li- 
mités, propose sa solution. Baptisé CD'TY, il est fondé sur 
un concept plus large que celui de ses concurrents, Le but 
du CDTY serait de remplacer d'autres sources de données 
numériques telles que les lecteurs de CD Audio, CD Vi- 
déo.. Les quelques applications présentées ne font pas as- 
scz. la différence entre le CDTV et l'Amiga pour qu’actuel- 
lement l'appareil apparaisse réellement intéressant. 


Réseaux 


Après plusicurs années de bons et loyaux services de ce 
bon vieil AppleTalk, Apple a finalement décidé de passer 
à la vitesse supéricure (10 Mo par seconde} pour les ré- 
seaux: LocalTalk va peu à peu être remplacé par Ether- 
net. Apple propose une série de cartes pour le Mac LC 
{2 090 F HT) et les Mac Il (carte Nubus possédant son 
propre processeur 68 000). Ces dernières seront utilisables 
sur tous les types de média (câble fin et paires torsadées). 


Claris : Pro ? 


Clans, après des rapports un peu compliqués avec Apple 
{contrôlée par le constructeur à la pomme, puis indépen- 
dante, et de nouveau sous le giron d’Apple!), s'apprête à 
lancer sur le marché des versions améliorées, dites “Pro”, 
de ses logiciels vedettes. FileMaker Pro, l'excellent ges- 
ionnaire de fichiers, est disponible depuis quelques mois. 
Mac Draw II Pro a été annoncé à la Mac World Expo. Il 
propose de séricuses améliorations (plus d'une centaine} : 
gestion de la couleur et des dégradés. intégration d'un vé- 
ritable traitement de texte, courbes de Bézier et outil de 
présentation de diapositives. 

Une version Pro de Mac Write EL vient d'être annoncée. 
Elle devrait incorporer la création de tableaux et la gestion 
d’index, Cependant, it est en cours de développement et 
toutes ses caractéristiques n'ont pas été encore fixées déli- 
nitivement. 
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Nouveaux Macs + La première imprimante Postscript level 2 existe. Elle | 


. ; s'appelle LZT 660 et est fabriquée par Dataproducts 
Les nouveaux Mac se vendent bien, très bien. op bien {$ 2095), Parmi toutes les améliorations de Postscript, on 
même car Apple n'arrive pas toujours à suivre la de- beut en citer une que beaucoup de monde attendait : la 


mande. À la surprise du constructeur, beaucoup d'achats Lossibilité de gérer des fichiers compressés/décompressés. 
ont été le fait de sociétés (PME-PMI et grands comptes}. 


Les utilisateurs individuels ne sont cependant pas en reste. Rouge = Rouge ? 
Conséquence de ce succès commercial, des éditeurs pas, 
ou peu présents sur le marché du Mac, regardent désor- 
mais cette machine d'un tout autre œil. Cela est particuliè- 
rement vrai dans le marché des jeux. Les éditeurs anglais, 
traditionnellement absents sur cette machine, s'intéressent 
désormais de très près au Mac. De même, les premières 
productions US débarquent. Première surprise: ce sont des 
jeux de qualité, On peut ainsi jouer sur son LC ou son ST 
avec Indiana Jones ou Dragon’s Lair en 256 couleurs 
{alors que les versions Amiga où ST n'en possèdent que 
16, ch, ch!}. 

Le marché des upgrades pour les nouveaux Mac est en 
plein boom. Plusieurs dizaines de sociétés proposent des 
solutions hard pour “doper” les Classic, SI, LC, C'est à 
qui proposera l'extension mémoire la plus rapide et la 
moins chère, l'écran 15”, pivotant ou non, la carte accélé- 
ratricc…., Du nouveau aussi prochainement chez Apple 
dans de domaine des périphériques (imprimantes, 
écrans) et des unités centrales. Clône 386 


Vrais Portables Le monopole de la production de 386 d'Intel semble 
prendre fin. AMD semble avoir mis deux équipes Sur le 
coup. La première étudiait la logique du composant ve- 
dette (la plus forte progression de vente pour les années à 
venir) d'Intel, alors que la seconde décortiquait physique- 
ment la puce (ce que l’on appelle chastement “Reverse en- 
gincering"). Le processeur clône d'AMD serait même plus 
performant que l'original {consommation d'énergie moins 
importante, vitesse de l'horloge pouvant passer à O0 Mhz 
en cas de non utilisation momentanée sur un portable par 
exemple..….}. Pour Ic moment, aucune décision juridique 
n'a été prise concernant la vente de cette puce, dans un 
sens comme dans l’autre. Il existe seulement un jugement 
qui autorise AMD à utiliser ‘386 dans Le nom de ses com- 
posants, 

Quelques chiffres européens La ruée vers l'Est 


+ Parts de marché en volumes en France (juillet-Septembre + Le Japon est, pour Apple, un marché qui explose. 1990 a 
1990, enquête Dataquest) : Apple 11,6 %, IBM 112%, été l’année où les Japonais ont véritablement croqué dans 
Compaq 8,6%. Commodore 7,2 %, Goupil 6,7 %, Atari Ja pomme. Certains prévoient même que la croissance des 
67 %, Bull 6,4 %, Autres 41,7 Ge. parts de marché dans l'archipel dépassera celle de la 
+ Apple France a terminé son exercice fiscal 90 avec une France ou de l'Europe. 

hausse de son Chiffre d'Affaires de 29 % soit 2,7 Milliards « Le gouvemement US a finalement décidé d'éliminer tout 
de francs (alors que celui d'Apple US n’a augmenté que contrôle sur les exportations de matériel basé sur le 486 à 
de 5 %). En Europe. Apple a amélioré son CA de 28 % destination du pays de la vodka et de la révolution proléta- 
{1.57 milliard de dollars). ricnne, 


Sur le front des imprimantes 


+ Au Comdex de Las vegas. on pouvait découvrir les pre- Apple USA vient d'ouvur une ligne téléphonique gra- 
mières imprimantes compatibles Truelmage. TrueType tuite pour “résoudre les problèmes de (nos} clients”. Ce 
doit être intégré dans la version 3.1 de Windows. Selon MES pas une hot-line technique , mais “une assistance 
certaines rumeurs, il se pourrait qu'Apple livre bientôt, Pour les personnes qui n'arrivent pas à obtenir entière sa- 
avec son imprimante à bulle d’encre 360 dpi dont le tisfaction de leurs concessionnaires” d'après John Coûk, 
prix tournerait autour de 3000 F HT, l'init Truelnit qui Et moi qui croyais qu'il n°y avait qu'en France que les 
permettrait de se servir de TrueType. concessionnaires n'étaient pas parfaits ! 


La recherche d'une restitution correcte de la couleur dans 
toute la chaîne graphique (du scanner couleur à l'impri- 
mante couleur en passant par l'écran) est le dernier dada 
de la plupart des sociétés américaines travaillant dans ce 
domaine, En cflet deux rouges annoncés comme identi- 
ques à travers leur référence du nuancier Pantone", ne sc- 
ront pas exactement semblables sur deux écrans différents, 
ni de l'écran au papier imprimé. Une première solution a 
consisté en li mise au point de calibrateurs par des socié- 
tés comme Radius. Ces petits appareils se collent à | 
l'écran et analysent la différence des teintes perçues par | 

{ 

| 


rapport aux couleurs d'une mire. Kodak vient de proposer 
toute une série d'utilitaires et d'outils de développement 
pour garantir que Ja couleur à l’écran sera identique à la 
hard copy. Cette nouvelle technologie porte le doux nom 
de Photo YCC et consiste en une méthode innovante pour 
représenter la couleur sous une forme digitale. 





Le marché des portables (vraiment portables, et non pas 
transportables, si vous voyez à quel portable je fais allu- 
sion...) n'en finit plus d'exploser. Tous les constructeurs 
travaillent sur des modèles style Carnets de Notes, en re- 
cherchant des solutions aux principaux problèmes qui se 
posent, à savoir l'autonomie des batteries, le poids du mt- 
cro et la qualité de l'écran. La dernière trouvaille dans ce 
domaine concerne le stockage des données. Après les mé- 
moires à bulles, les disques durs de 2,5", les drives de 2,88 
Mo. la dernière nouveauté réside dans les cartes à mé- 
moire Flash, Ces mémoires d'Intel à semiconducteurs pè- 
sent 28 g, ont des lemps d'accès de 8 Mégaoctcts par sc- 
conde et existent en version de 1 Mo ou 4 Mo, 


Apple Service Team. 
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Mac Eraser : le source 


Olivier Goguel 


[NDLR: Lecteurs, savourez vos privilèges. ToolBox Mag, qui vous avait déjà offert un Tool du 
“Pape du No-Tools”, qui vous offre un super-jeu du même auteur dans ce numéro même, réussit 
le tour de force historique de publier un source vraiment commenté d'Olivier Goguel ! 

Rappelons que le programme “Mac Eraser” (cf ToolBox Mag 3) permet au GS de faire ce que le 
Mac ne sait pas faire: effacer ses disquettes sans les reformater. Le source Merlin va vous mon- 
trer entre autres comment lire et écrire les blocs de 524 octets - les S12 habituels plus les 12 de 





MAC ERASER v1.0 
Olivier Goguel 


ORG $800 
XC 
Msg DS2 


SEI pas d'interruptions autorisées 
STA $C000 /nirialisarions 

STA $C00C 

JSR $FE93 

JSR $FE89 

JSR $FB2F 

JSR $FCS8 

STA $CO0F 


INC SO3F4 Force un reboot si on appuie sur 
Cirl--Reset, pour éviter de 
rester avec des appels trafiqués. 


JSR Print 
MAC ERASER v1.0”,8D 


FELS "LLLLLLLLLLLLLLL"00 MouseText 
JSR Print 

DFB 20 

ASC"  TODAY'S QUOTE :" 8D 

FLS "SSSSSSSSSSSSSSSSSSSSS" 

FLS "SSSSSSSSSSSSSSSSSSS" 

ASC "FOR EVERY MACINTOSH SOLD",8D 
ASC " THERE IS AN IDIOT BORN !" 00 si! 


Déconnecte un éventuel Diversi-Cache (ou autre 
routine barbare) en remettant les valeurs par dé- 
faut des vecteurs du smartport 


LDX #0 

Jp  LDAL $E10F6F+4,X 
STAL SE10F6F,X 
INX 


LDAL $E10F6F+4,X 
STAL $E10F6E,X 


INX 

LDAL $SE10F6F+4,X 
STAL $E10F6F,X 
INX 

LDAL $E10F6F+4,X 
STAL $SE10F6F.,X 
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“signatures” (tags) - des disquettes Macs... sans Mac.] 


INX 
INX 

INX 

INX 

INX 

CPX 488 
BNE JIp 


Tout ce qui concerne la lecturelécriture de 
blocs de 524 octets se trouve réuni ici. 

Les routines de la Rom peuvent par défaut 
liretécrire des blocs de 512 ou 524 octets. I y a 
en théorie un appel permettant de travailler 
avec la longueur voulue: mais l'absence de do- 
cumentation officielle complète du smartport 
fait que cet éventuel appel ne se trouve docu- 
menté nulle part. Heureux possesseur de la do- 
cumentation du drive 3.5, pense aux autres... 
Puisque l'on ne peut pas dire proprement au 
smartport que l'on Veut travailler avec des 
blocs de 524, on va lui forcer la main “sauva- 
gement”. 

En examinant un tant soit peu les routines du 
smartport, ef en particulier les routines de 
postipré-nibblisation, on rencontre un drapeau 
($E10FS51) qui indique au smartport la taille 
des blocs. S'il est à $00, on va travailler en 512 
octets par bloc, s'il est à $FF on travaillera 
avec des blocs de 524 octets. 

Un de mes premiers patches a été de forcer ce 
drapeau à $FF avant chaque appel smartport. 
Cette méthode relativement simple à mettre en 
œuvre ne marche pas: le smartport initialise ce 
drapeau à $00 à chaque nouvel appel. 

On va donc être obligé de forcer ce drapeau, 


. mais à un niveau plus bas dans le smartport. 
, Pour cela, on va détourner un des vecteurs du 


smartport, en l'occurrence celui situé en 
$SE10FA7, qui correspond à un des dispatchers 
principaux du smartport, et envoie, selon l'ap- 


. pel demandé, aux routines de lecture/écriture. 


On va tout simplement forcer, en détournant ce 


: vecteur, le drapeau $E10FS]I à $FF, puis conti- 
. nuer l'exécution normale du smaäriport en se re- 
: branchant sur l'ancienne adresse détournée. 
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LDAL $EIOFAS On sauvegarde l'ancienne BCC Chiffre 











STA NormalVect+1 valeur du vecteur concerné ADC #"A"-"9"-2 
LDAL $SEIOFAQ pour pouvoir la restaurer Chiffre RTS 
rh ea lorsqu'on voudra quitter, NoWriteProtect PHA 
STA NormalVect+3 L : n #$F0 
LDA #<Detour On met à la place LSR 
STAL $E10FAS l'adresse de notre LSR 
LDA #>Detour routine. LSR 
STAL SEIOFA9 JSR Translate 
LDA #Detour STA ErCode 
STAL SEIOFAA PLA 
+ AND #$0F 
BRA Continue JSR Translate 
STA ErrCode+1 
La routine suivante sera exécutée à chaque appel de lec- ISR Print 
turetécriture par le smartport. DFB 13 
MX 11 DEB "G'"&S9F 
ASC "AN ERROR 5" 
La rouiine est appelée avec : B=$E1 et x=1,m=1 ErrCode ASC 2? OCCURS: OPERATION CANCELED," 
Detour LDA #SFF Force le drapeau SE10FS] ne 
STA $0F51 à $FF (B=$EI à l'appel} 
NormalVect IML $000000 et on retourne normale- NoPbm LDX #2 Temps d'attente 
ment au SMArTTPOr... JSR Print 
DEB 13 
La suite du programme ne présente plus de difficulté. ASC " OPERATION SUCCESSFULL...",00 
Continue JSR EjectDisk ContErr JSR EjectDisk 
Imainloop JSR Print | lp LDA $C019 NDLR: VBL: vrainient utile ici? 
DEB 9 BPL }lp 
ASC" PRESS Q TO QUIT "8D8D Hp EDA $CO19 
ASC " OR ‘"8D8D BMI Jip 
ASC" INSERT ANY DISK" BRL. ]Jmainloop 
ASC "TO BEERASED "00 _ 
W'aitKey STA $C010 Quit JSR SFB2F 
lp  LDA $C000 scrute le clavier JSR SFCS8 home 
BPL NoKey Avant de sortir, on enlève notre détournement en remet- 
CMP #"Q" tant la valeur du vecteur par défaut. On risquerait 
: : na: d'avoir des ennuis si on continuait de travailler avec des 
BEQGoQuit  Appaie sur  : Qui Mr pr 
BNE WaïtKev LDX #3 
7 ; Jp  ILDALSEIOFAB,X 
GoQuit BRL Quit STAL SE 1OFA7.X 
NoKcey JSR GetEntry DEX 
BEQ ]Ip Attente de l'insertion d'un disque BPL |lp 
JSR Print LDA #0 
DEB 9 STAL $E10FS1 
ASC"  ERASING DISK..." 8D8D CLI 
ASC " ",8D8D 
ASC "00 | JSR $BFO0 Prodos MLI 
JSR Erase Disk Effacement du disque DA E él ou 
BCS SomePbm QuitParm HEX 04 
BRL NoPbm DS 6 
SomePbm LDX #20) —————. — 
CMP #S2B Ejcct_Parm HEX 030100000400  éjecte stat S drive 1 | 
BNE NoWriteProtect W'ait_Parm HEX 0301 
JSR Print Re 
RE Entry DS 1 
DFB "G'&S9F Dee 
ASC pus ARE PROTECTED:" 
ASC "OPERATION CANCELED" ; - SR ue 
urA EjectDisk JSR $C50D appel SmartPort 
DFB "G"&$9F,00 HEX 04 
BRA ContErr | DA Eject_Parm 
. JSR GetEntry 
D enr BNE EjectDisk 
CMP #"9"+1 or 
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attend l'introduction 
d'un disge (appel status) 





Cac es $C50D 
X 00 


DA Wait_Parm 
LDA E 
AND #51 
RTS 


















































un seul bit nous intéresse 





Erase Disk STZ Block 
"STZ Block+ 1 


LDA #<Frec 
STA Mem 

LDA #>Frec 
STA Mem+l 


On travaille tout-à-fait normalement avec les blocs de 
S24 octets en faisant des appels totalement classiques. 


Joop JSR $CS0D smartport 
DFB (2 Write 

DA ReadParm 

BCC NoErr 


RTS 
NoËErr LDA Mem 
ere 


FER FH EL + $- EE EE F5 + 


ADC #<524 
STA Mem 
LDA Mem+t 
ADC #>524 
STA Mem+1 


INC Block 

LDA Block 
CMP #$1D 
BNE Jloop 

ÉEC 

RTS 


ReadParm HEX 03 


ça suffira 


Blœk ADRL Q 















Print PLA routine d'affichage 
STA Msg sur l'écran texte : 
. À 
AMsg+l ‘! 2 
INC Me Légalité 
Sr de SD) On peut écrire légale- : 
à SR SFB5B | : ment des blocs de 524 oc- 
TZ 824 tets avec l'appel $2030 de 
Phi de den | G8/O8 (cf GS/0S Refe- 
JSR SFDED : rence vol 2, $2029 pour la 
INC Msg ee 
INC Mie Sr Mac Eraser est sous P8 et 
BRA [loop S'en moque. Sauf sur un 


point: cela va permettre à 
Olivier de trouver le 
“vrai” vecteur ou le 
. “vrai” drapeau. 

. Rendez-vous dans un 
: prochain ToolBox Mag. 


JYB 


EndTxt LDA Msg+l ! 
PHA 
LDA Msg 
PHA 
RTS 


DS\ 
Free = 


À cet endroit se trouvent les données relatives aux deux 
premières pistes d'un disque SO0k macintosh. Ces data 
sont sans intérêt. Vous pouvez les retrouver sur le pre- 
granune assemblé. 
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TootTableDeb. Anop :. 


dc.w ToolNum0S, MinVersion 


ToofTablcEnd ANnop 


LANCEZ.MOI du catalogue /DIVERS de la 
disquette et vous saurez si vous êtes à jour. 
Attention: ce n'est pas un poisson ! 

Auteurs de ToolBox Mag, vous trouverez au 
même endroit un petit source Merlin appelé 
GetVersion. Introduisez s'il vous plaît ces 
lignes au tout début de chacun de vos pro- 
grammes, que les lecteurs sachent ce qui se 
passe au lieu d'attendre le plantage. 

Notez le truc (certifié par le Bureau Politi- 
que}: comme les outils ne sont pas là, on en- 
voie au DeathManager par un JumpLong sur 
son vecteur. 


Re 
| 
Lecteurs de TooëBox Mag, lancez le fichier 
| 
| 
| 
; 
Î 





























Init ToolsToRam: : 
Table des outils à choper 


de.w ToolNumti MinVerion È 
de.w ToolNumO2,Min Version 
de.w TooÏNum03 Min Version. 
de.w TooiNum04 MinVersion 
dc.w ToolNumf5 Min Version 
de.w ToolNum06,MinVersion 
de.w ToolNum07, Min Version 


de.w ToolNum(9 MinVersion 
de.w TooïNum 10 Min Version 
de.w ToolNumi1.MinVersion 
dc.w TooïNum 2,Min Version 
de.w ToolNumi3 Min Version 
dc.w ToolNum 14,Min Version 
dc.w TooëNumi5 MinVersion 
de.w ToolÏNum 6, Min Version 
de.w ToofNum£? MinVersion 
de.w ToolNum£8 Min Version 
de.w ToolNumi9 MinVersion 
dc.w ToolNum20 Min Version 
de.w ToolNum21 Min Version 
de,w Too)]Num22,MinVersion 
de.w TooiNum23 Min Version 
de.w ToolNum24,Min Version 
de.w ToolNum25.Min Version 
de.w ToolNum26.MinVersion 
dc.w ToolNum27 Min Version 
dc.w ToolNum28 Min Version 
dc.w ToolNum29 Min Version 
de.w ToolNum30,Min Version 
dc.w ToolNum31.MinVersion 
dc.w ToolNum32 Min Version 
de.w ToolNum33 .MinVersion 
de.w ToolÏNum34,Min Version 
de.w ToolNum35 Min Version 
dé.w ToolNumS$9 Min Version 
dc.w ToolNum219 MinVersion Lisez TooiBox Mag 


WindoswManager 
MenuManager 
ControlManager 
System Loader 
QuickDraw Aux 
PrintManager 
LineEdit 
DialogManager 
ScrapManager 
StandardFile 


Note Svnthetizer 
Note Scquencer 
FontManager 
ListManager 
Ace 


Midi 

Video Overlay 
TextEdit 

MidiSynth 
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Et voici le GS Roms O5 | 





Patrick Desnoues 


Une des caractéristiques les plus attendues du 
futur GS sera d'avoir l'essentiel de ses outils en 
Rom: c'est déjà ce qui se passe en partie avec le 
GS Rom 03, qui vous demande bien moins sou- 
vent que son prédécesseur d'introduire la dis- 
quette système. 

Eh bien, ce nouveau GS, ToolBox Mag vous 
l'offre dès aujourd'hui: avec la petite Init ci- 
dessous appelée Tools ToRam, vous chargez en 
mémoire tous vos outils qui sont sur le disque 
système au moment du démarrage, et ensuite ils 
y restent! La Ram remplace la Rom. Cela fait 
gagner pas mal de temps ensuite au moment du 
chargement des applications, et vous évite 
d'avoir à introduire la disquette système à tout 
bout de champ: les applications ayant besoin de 
TextEdit, FontManager, StandardFile et, 
n'ayant plus à les charger, n'auront évidemment 
plus à les purger. 

L'occupation de la Ram est beaucoup moins im- 
portante qu'on ne croit: en fait, il ne vous en 
coûtera guère que 73k de mémoire. Voilà de 
toute façon une bonne raison de plus pour ne 
pas rester juste en mémoire: avec les accessoires 
et les outils tous en mémoire vive, il ne reste 
plus guère que les fontes pour demander la dis- 
quette système. 

Nous pourrions même peut-être, à ce compte, 
réviser notre position sur la note 53 du Bureau 
Politique; si tous les outils sont déjà en Ram, on 
peut peut-être accepter la gymnastique deman- 
dée par Apple. 


Lors de votre prochaine rencontre avec John 
Sculley, pensez à lui parler de l'init ToolsToRam 
de ToolBox Mag: ToolBox étant ouvert à la né- 
gociation sur ses droits, rien n'empêcherait 
Apple de mettre dans son prochain système 
une init du même genre (après mesure de la 
Ram présente, comme c'est déjà le cas pour Ex- 
pressLoad), ou, mieux, de nous permettre de 
choisir quels outils nous voulons charger en mé- 
moire au prochain redémarrage. 


Le programmeur constatera qu'il s'agit d'un 
programme du type “il suffisait d'y penser”. 
L'astuce consiste à faire un LoadTools dans 
une init: dans une application, le système force 
la purge des outils en sortie. 


ToolBox Mag n° 4 


Pour l'utilisateur, précisons que l'init en ques- 
tion, appelée Tools ToRam, doit être copiée de- 
puis le catalogue /RAMTOOLS.INIT/ de la dis- 
quette pour être mise dans le sous-catalogue 
{SYSTEM /SYSTEM.SETUP de votre disque de dé- 
marrage. Vous pourrez choisir de l'activer ou de 
la désactiver avec le Finder ou Prosel (si vous ne 
savez pas activer/désactiver un accessoire ou 
une init avec le Finder, téléphonez à l'Apple Il 
Service Team d'Apple France). 


Pour choisir quels outils vous voulez charger 
au démarrage, il faudra en revanche réassem- 
bler le programme (c'est très vite fait, il est très 
court), en partant de la table ci-contre page 18: 

+ Les lignes commençant par une ‘*' correspon- 
dent aux outils qui sont déjà en mémoire morte: 
inutile de les charger. 

+ Il suffit de mettre un ‘;' en début de ligne pour 
que l'outil ne soit pas chargé. C'est ainsi que, 
dans la version assemblée qui se trouve sur la 
disquette ToolBox Mag, ne sont pas chargés les 
outils ToolBox Mag, ni les outils sons, ni le 
Control Manager (pour tenir compte d'un bug 
stupide de Wings: si vous n'utilisez pas ce sélec- 
teur, mettez-le), ni l'outil pour la Video Overlay 
Card. 

I suffit d'enlever ce ‘;', et l'outil correspondant 
sera Chargé. 


[NDLR: ce programme de Patrick Desnoues nous 
semble susceptible de développements. Un des pre- 
miers dont nous serions preneurs est tout simpre- 
ment un programme Applesoft permettant à son uti- 
lisateur de créer sa version de ToolsToRam, en choi- 
sissant ses outils dans un menu, sans avoir à réas- 
sembler avec APW! IT suffit d'assembler une version 
avec une fable de 255 outils placée en fin de code 
pour faire un code objet parfaitement “patchabie" 
ensuite sous Prodos 8.] 


Comme d'habitude: 

LK : Link 

MK : Génère les macros 

Linkail : Nom des sources à compiler 

Macros : Liste des macros générées 
par la commande MK 

Main : Programme 


<— Voir Table des outils Page 18 
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Tesf Logiciel : NWords 


Le GS sait lire | 


Bernard Fournier 


! 


: Plus simple que sur M... 

| Plus rapide que sur M... 

Plus efficace que sur M... 
Plus économique que sur M... 


InWords, le logiciel d'OCR du GS, 


| Attendu depuis plusieurs mois, il est enfin arri- 
| vé: le logiciel de Reconnaissance Optique de 
| Caractères. Son auteur, Alan Bird, program- 
meur chez Beagle Bros, à pour la circonstance 
fondé une autre Société (WestCode SoftWare). 
Il est bien entendu indispensable de posséder 
un scanner: InWords est étudié pour fonction- 
ner avec le scanner Quickie de chez Vitesse (il 
n’est pas impossible qu'il pilote d'autres scan- 
ners dans ses versions ultérieures). 
| 


Premier contact 


InWords est livré sur deux supports: disquette 
31/2 et disquette 51/4, et un manuel consé- 
quent accompagne le programme. Première 
chose: on branche sa Quickie, on met la dis- 
quette mWords dans le mange-disque et on 
démarre. Deux secondes et trois dixièmes plus 
tard on est dans le menu principal: pas étonnant 
ce chargement rapide, car InWords fonctionne 
en Prodos 8 (mais on peut également lancer le 
logiciel à partir du Finder). 


Le menu principal a un air de déjà vu: il utilise 
en effet l'interface utilisateur Appleworks, ce 
qui est somme toute un excellent choix pour un 
programme 8 bits. Les options proposées per- 
mettent d'effectuer un scan de texte, de passer 
en mode apprentissage ou de changer la police 
de caractères. Plus simple, tu meurs ! 


D'abord, deux mots sur la reconnaissance opti- 
que: le scanner ‘lit le document posé sur la 
table et le logiciel ‘interprète’ ensuite les formes. 
Pour convertir une succession de points lumi- 
neux en lettres, InWords utilise une table de ré- 
férence: dans cette table (la police de caractères) 
sont stockées les formes de chaque lettre de l'al- 
phabet (ainsi que les signes, ponctuations, 
chiffres...), Une succession de points lumineux 
correspondant à une forme de la table sera tra- 
duite en son ‘équivalent’ ASCII. Simple et ef- 
ficace, non? 


La possibilité de charger une fonte ainsi que le 
mode apprentissage permettront de définir nos 
propres tables de caractères selon la typogra- 
phie des textes que l'an voudra analyser. Le lo- 
giciel est fourni avec une dizaine de fontes cor- 
respondant aux typographies employées par les 
principales revues Américaines consacrées à 
l'Apple. Il est donc nécessaire de se créer ses 
propres tables, ne serait-ce que pour pouvoir 
reconnaître les minuscules accentuées. 


Créer une table de formes 


L'apprentissage (la constitution d'une table de 
référence) est on ne peut plus simple: on règle la 
Quickie sur la position LETTER, la résolution 
est fonction de la taille des lettres: 


+ 400 dpi pour un corps de 10 
+ 300 : 14 
° 200 ; 24 
+100 A >24 


Enfin on règle la luminosité: pour un premier 
essai, mettre le repère en face du D de DARK. 
Ensuite on passe aux réglages logiciels: indiquer 
que l'on va créer une fonte, spécifier que l'on va 
procéder à un apprentissage et régler le degré 
de correspondance des formes à 70% (faire 
éventuellement varier ce taux selon la qualité 
d'impression du texte à analyser: plus le texte 
est de bonne qualité, plus le taux sera élevé, et 
plus InWords sera fiable dans ses analyses). 

On choisit l'option Standard Scan et immédiate- 
ment la Quickie s'allume, prête à digitaliser; une 
fois le texte scanné, un écran Double Haute Ré- 
solution affiche une portion du texte dipjitalisé. 
Cet écran (que lon peut déplacer avec les 
flèches) est l’image graphique du document: ce- 
la permet de contrôler si les caractères ont été 
correctement lus (ajuster la luminosité si besoin 
et recommencer jusqu'à obtenir des lettres bien 
formées, pas trop épaisses ni trop ‘fil de fer’). 
Lorsque la digitalisation semble correcte, on ap- 
puie sur Return et l’analvse des caractères va 
s'effectuer. InWords étant en mode apprentis- 
sage, il va détecter la première forme parmi le 
texte digitalisé, va détourer cette forme et de- 
mander à quel caractère (ou séquence de carac- 
tères} elle doit être associée. On tape la touche 
correspondante (ou la séquence de touches) et 
désormais InWords ‘reconnaîtra’ la forme ana- 
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lysée comme étant la représentation du carac- 
tère (ou des caractères) qu'on a indiqué. Lors- 
que l'apprentissage est terminé, on peut sauver 
la fonte pour pouvoir en disposer ultérieure- 
ment (voire pour la compléter). 

Remarque: les minuscules accentuées utilisant 
l'accent circonflexe ou le tréma devant être tra- 
duites en caractères ASCII <128, le program- 
meur a utilisé la méthode suivante: on peut spé- 
cifier à InWord qu'une forme devra être tra- 
duite en une suite de plusieurs caractères AS- 
CIE. Par exemple: 


â -> fa 
ë => ‘e 
© -> (c} 


Avec ça, aucun problème pour analyser tous les 
textes possibles, même ceux mélangeant carac- 
tères US et minuscules européennes: tout est 
question d'apprentissage pour InWords. 


Dans l'option Fonte du menu principal, on à la 
possibilité d'éditer les caractères de la table: 
cette option permet en réalité de visionner le 
nombre de formes différentes associées à un 
même caractère ASCIT (on peut également sup- 
primer une ou plusieurs formes en cas d'er- 
reur). En effet, si un texte possède des variantes 
dans les formes d'une même lettre, nWord va 
enregistrer toutes ces variantes comme étant 
équivalentes à un seul caractère ASCII. 
Exemple: 

aaaa seront associés au caractère a, 
et dans la table des formes, en face de ‘a’ sera 
indiqué 4, pour rappeler que 4 formes diffé- 
rentes sont associées au caractère ‘a’. 
Une fois encore, tout est question d’apprentis- 
sage. InWords peut faire tout ce qu'on veut, à 
condition de le lui avoir appris ! 


Les fonctions avancées 


On dispose de trois modes de scan: standard, 
colonne et lier. Le premier mode correspond au 
scan d’un texte de moins de 10 cm de large 
(cette largeur est celle du scanner; la longueur 
étant fonction de la mémoire disponible). Les 
deux autres modes sont nettement plus intéres- 
sants: le mode colonne va permettre de distin- 
guer un texte formatté en colonnes; et le mode 
lier va permettre de scanner un texle disposé en 
lignes de moins de 20 cm. 


Mode Colonnes: imaginons un texte dispasé de 
la manière suivante: 


XXXX X XXX XXXXX XX 
XXXXXXX X XXXX XXX 


ÉD SÉIA SAS ES 

AE LE EP di EE PS à 

Ce texte est disposé en colonnes; le scan se fai- 
sant sur une largeur de 10 cm, en mode stan- 
dard chaque ligne serait analysée avec une 
partie de la colonne 2. En employant le mode 
colonne, on indique à InWords que les espaces 


en fin de ligne sont à considérer comme la fin de 
la zone à analyser. On va donc pouvoir scanner 
les colonnes les unes après les autres, le texte se- 
ra analysé correctement. 


Mode Lier: avec un texte ayant une largeur su- 
périeure à 10 cm (et inférieure à 20 cm), ce mode 
permet de scanner la partie gauche puis la par- 
tie droite (sans se soucier d'un éventuel chevau- 
chement): InWords détectera les chevauche- 
ments et les corrigera en conséquence. 


Les textes analysés sont sauvés soit en format 
Texte (CR en fin de ligne), soit en format Apple- 
Works-8, ce qui permet leur exportation dans 
tous les traitements de texte du GS. 


Les limites d'InWords 


° InWords est extrêmement sensible au réglage 


de la luminosité de la Quickie, cela signifie éga- 


lement qu'il ne peut reconnaître que du texte 
bien contrasté (noir sur fond blanc). 
+ On ne peut pas scanner un texte comportant 


des zones graphiques (il manque la possibilité | 


d'indiquer au logiciel que certaines zones sont à 
occulter): il reste la méthode du masquage avec 
des Post! 

+ Le logiciel fonctionne avec des lettres de taille 
10 minimum: avec des tailles inférieures, il ne 
peut distinguer les formes et fait des confusions. 
De même, l'espacement entre les lettres doit être 
suffisant pour qu'il puisse les distinguer les 
unes des autres, sinon bonjour les confusions 
entre ‘ri et ‘n° ou entre ‘nn’ et ‘’m’. Pour pallier 
cet inconvénient, on peut toujours agrandir le 
texte avec une photocopieuse qui permet 
l'agrandissement. 


+ Les lettres doivent être bien formées (qualité : 
laser, photo-gravure, offset} ce qui exclut les lis- : 


tüings produits par une imprimante matricielle, 
les textes des magazines bon marché, et bien 
évidemment les textes manuscrits. 

+ Enfin les confusions inévitables pour ce type 
de produit: les Q (chiffres) et Q (lettres), les I ( 
majuscule} et les 1 (le chiffre), et dans une 
moindre mesure (tout dépend de la taille des 
lettres) les O, D et ©. 

+ Et puis malheureusement, il faut signaler les 
trop nombreux plantages du logiciel: défaut de 
jeunesse cerles, mais défaut tout de même... 
heureusement qu'il suffit de faire Control-Reset 
peur revenir dans InWords sans perdre le docu- 
ment en mémoire; mais quand même cela fait 
désordre ! 


Malgré ces quelques restrictions, à l'usage on 
constate qu'InWords reconnaît les textes avec 
un pourcentage d'erreur inférieur à 2%. Les 
phases d'apprentissage doivent requérir toute 
l'attention et le soin de l’opérateur: de la quali- 
té de son travail dépend la fiabilité de ses recon- 
naissances optiques futures. 
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Un GS grand écran : 





Border GOhOËE ne oo 


Mais non, les bordures de votre écran ne sont 
pas des zones vides, neutres, sur lesquelles on 
ne peut rien afficher: “Border Scroll”" va vous 
montrer comment afficher et faire défiler du 
texte dans la bordure inférieure de l'écran! 


L'utilité d'une telle routine n'est pas évidente, 
(encore que l'on puisse par exemple imaginer 
un programme de dessin plein écran avec des 
options dans la bordure): prenons donc sa réali- 
sation comme un défi intellectuel et une occa- 
sion de discuter certains aspects du GS dont on 
parle peu. 


Pour l'utilisateur 
| 
1 


Passez sous Basic System. Quand vous voyez le 
\ “prompt” du Basic, tapez franchement Control- 
Reset (pas G-Control-Reset, qui vous ferait re- 
booter, mais un Reset simple). Il est en effet pos- 
sible, si vous êtes sous G5/05, que d'autres que 
“Border Scroll” envoient des interruptions, 
cherchent à se synchroniser sur les VBL, etc, et 
empêchent par là Border Scroll de rester syn- 
chronisé. Tapez ensuite: 


BRUN /TOOLBOX.MAG.04/ BORDER. 
SCROLL/BORDER. 


La fenêtre centrale de votre écran va alors pas- 
ser en bleu. Mais regardez bien ce qui se passe 
en-dessous: vous voyez du texte défiler dans la 

. bordure! Vous pouvez interrompre et reprendre 
le défilement à tout instant en tapant -Option- 
Control-Shift-Delete. Pour quitter Border Scralil, 
un Control-Reset suffira. 


Pour le bidouilleur 


Quel que soit le mode graphique dans lequel se 
trouve le GS, la bordure est toujours présente. Il 
est intéressant de noter que sa position peut va- 
rier quelque peur: ainsi la limite inférieure écran- 
bordure est plus basse en Super Haute Résolu- 
tion qu'en mode texte. En théorie, la bordure est 
de couleur uniforme, choisie parmi les 16 dispo- 
nibles. 

L'astuce que nous allons utiliser consiste à chan- 
ger la couleur de la bordure le plus souvent 





possible, tout en gardant le 65816 parfaitement 
synchronisé avec le VGC (processeur graphi- 
que). L'animation synchronisée sera exécutée en 
vitesse lente, à 1 Mhz. 


Avant toute chose, livrons-nous à quelques cal- 
culs (pour lequels nous supposerons le GS en 
vitesse lente) : 

À 1 Mhz, nous disposons d'environ un million 
(1076) de cycles par seconde. En une seconde le 
processeur vidéo balaye l'écran 50 fois (en 50 
HZ), nous disposons donc d'environ 10%6/50 = 
20 000 cycles de microprocesseur par balayage. 
Maintenant, un écran complet (bordures com- 
prises) en 50 HZ correspond à 312 lignes ba- 
layées. Le nombre de cycles correspondant au 
balayage d'une seule ligne est alors : 20 000/312 
= 64.10 . En pratique, on verra que ce nombre 
est en fait de 65. 

Afin d'obtenir la meilleure ‘résolution possible, 
il faut changer la couleur de la bordure le plus 
souvent possible: ceci sera accompli en utilisant 
les formes courtes (page zéro) des instructions 
de stockage, ce qui présuppose que l'on posi- 
tionne la page zéro au bon endroit! 

L'astuce consiste à assigner la valeur $C000 au 
registre D de page directe (mettre la page zéro 
en $C000), ce qui permet d'adresser le registre 
de la couleur d'écran ($C034) par de simples 


Références 
Qu'est-ce que le VGC? Le registre 


$C0?2F? Quest-ce qu'un cycle du mi- 
croprocesseur? Une seule réfé- 


rence: le livre “Le Il GS Epluché”. La > 
partie “graphisme et animations” de 
ce livre a pour auteur... Dominique 


Delay. 


Dominique est aussi l'auteur, vous & 
l'avez noté, de l'animation de pré- # 
sentation de la disquette ToolBox 
Mag 4. N'oubliez pas de booter la 
disquette | JYB 
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STX $3%4. Cette instruction prenant 3 cycles, nous 
aurons une ‘résolution’ de 65/3 = 21 éléments 
horizontaux. 

Arbitrairement, la largeur de nos caractères sera 
de 3 éléments, 4 avec l'espace qui les suit, nous 
permettant ainsi d'afficher 5 caractères simulta- 
nément à l'écran. Leur hauteur sera de 14 lignes, 
avec une ligne sur deux laissée noire, simple 
question d'esthétique. 


Arrivés à ce stade, nous savons que, une fois 
synchronisés, nous n'avons plus qu'à changer la 
couleur de la bordure tous les 3 cycles, avec un 
modulo de 65 cycles, pour obtenir une figure 
stable à l'écran. La question qui subsiste est bien 
entendu comment se synchroniser ? 


Comment se synchroniser ? 


En fait, la méthode utilisée est très empirique. 
Le balayage vidéo se faisant “en Z” (balayage 
d'une ligne, retour à zéro, descente d'une ligne), 
il est facile de se synchroniser verticalement: il 
suffit d'attendre une valeur particulière du re- 
gistre VERTCNT ($CO2E). 

En revanche, la synchronisation horizontale est 
une autre affaire. Le registre HORIZCNT (5C02F), 
reflète bien à tout instant la position horizontale 
du faisceau, mais sa valeur change bien trop ra- 
pidement pour que l'on puisse à coup sûr se 
synchroniser sur une valeur particulière (un tri- 
plet LDA CMP BNE prend au minimum 7 cycles, 
soit 1/9 du temps de balayage d'une ligne!}. Si 
seule la synchronisation horizontale importait, 
on pourrait attendre que HORIZCNT ait une va- 
leur particulière, mais dans notre exemple, on 
désire être synchronisé à la fois verticalement et 
horizontalement ! 


Dans ce cas, une seule solution subsiste : se syn- 
chroniser verticalement en attendant une valeur 
particulière de $C02E, puis lire $CO2F et exécuter 
une routine de temporisation différente pour 
chaque valeur possible lue à ce moment précis. 
Le nombre de valeurs différentes que l'on peut 
lire est (toujours empiriquement) de 8, elles dé- 
pendent de la désynchronisation qui existe à cet 
instant précis entre le VGC et le 65816, le VGC 
‘travaillant’ plus vite que le processeur. 

Après le passage au travers de la routine (com- 
posée d'une série de CMP, branchant à diffé- 
rents niveaux d'une série de NOPs et autres 
BITs, prenant respectivement 2 et 3 cycles), le 
VGC et le 65816 sont parfaitement synchronisés. 
En pratique, cela signifie qu'un LDA $C02F sui- 
vant directement cette routine donnera toujours 
la même valeur. 
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Défilement du texte 


Une fois la synchronisation obtenue, un certain 
nombre de routines composées de 21 STZ/STX 
courts +un NOP, totalisant ainsi 3*21+2 = 65 
cycles, sont exécutées. Le registre X est au préa- 
lable chargé avec une valeur représentant une 
couleur de bordure: chaque STX correspond à 
l'affichage d'un élément plein, alors que chaque 
STZ (STore Zero) correspond au passage de la 
bordure à la couleur noire. 


Pour faire défiler ce texte, nous pourrions sim- 
plement bouger les instructions STX/STZ dans 
la routine elle-même, mais notre ‘résolution’ de 
mouvement ne serait que de 1/2ie de l'écran 
environ! Encore pire qu'un scroll en mode 
texte ! 

Pour améliorer le pas de défilement, on peut 
agir directement sur la routine de synchronisa- 
tion, en rajoutant ou en enlevant un cycle à ia 
fin de cette dernière. Un cycle correspond à 
1/65 d'une ligne, le pas le plus fin que l'on 
puisse avoir. 


On est de toute façon obligé de bouger les in- 
structions au cœur de la routine (correspondant 
à un pas de 3 cycles), mais pour que le mouve- 
ment soit le plus fin possible, on procède 
comme suit : on a trois routines de temporisa- 
tion post synchronisation, chacune différant de 
la précédente d'un seul cycle. Au premier ba- 
layage, on exécute la première routine, au 
deuxième balayage la deuxième, au troisième 
balayage la troisième, puis, lors du quatrième 
balayage, on bouge les instructions à l'intérieur 
du programme tout en recommençant à exécu- 
ter la première routine de temporisation... et 
ainsi de suite. 


Notes finales 


Le reste de la routine est assez classique. H est 
encore intéressant de noter que l'on peut facile- 
ment rajouter un dégradé de couleurs dans les 
caractères, en transformant les NOPs coincés 
entre les instructions de stockage en LDX, chan- 
geant ainsi la couleur à chaque ligne. 


Si l'on désire afficher une page SHGR en même 
temps que le scroll, il vaut mieux repasser en 
mode texte (C029:41) avant de se synchroniser, 
sous peine d'avoir des ‘parasites autour des 
barres. 


Vous trouverez le source Merlin dans le sous- 
catalogue / Border.Scroll/ de la disquette Tool- 
Box Mag 4. 
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avant de 


Le GS pour débutants 
première partie : 


démarrer 


Eric Weyliand 


A lire votre courrier, à vous répondre au téléphone, 
on se dit que les ventes d'Apple Il GS ont dû 
connaîire une gigantesque explosion ces derniers 
temps: c'est fou le nombre de “débutants” qu'on 
trouve sur cette machine ! 

Vous qui êtes perdu dans la jungle des Inits, CDevs, 
Drivers, ProDos, P8, GS/OS, CDA, NDA, Fontes, 
Tools, PIF, TIE, S16, SYS, Icône, Control Panel, 
vous qui appelez ou écrivez à ToolBox Mag pour de- 
mander comment on lance un accessoire de bureau, 
ou pourquoi vous n'arrivez pas à lire vos disquettes 
5,25, cette série d'articles vous est destinée: après sa 
lecture (qui suppose que vous avez déjà lu les docu- 
mentations remises avec le GS et avec son système), 
vous n'aurez plus l'excuse d'être un débutant. Si 
vous frouvez ces explications trop difficiles, une 
seule solution: téléphoner à l'Apple IT Service Team 
d'Apple France. 

Vous qui n'êles plus débutant, jetez-y quand même 
un coup d'œil: je tâcherai de faire celte initiation de 
façon à passer tout de suite à une pratique “évoluée” 
du GS, en raccourcissant le chemin que nous avons 
tous dû prendre pour savoir gérer la Bram ou char- 
ger des accessoires. 


Avez-vous vraiment un Apple II GS ? 


Tout d'abord, assurez-vous que vous possédez 
un véritable Apple IIGS. Voici le minimum 
que vous devez avoir: 


+ Un moniteur (un écran) relié à l'ordinateur: 
couleur ou monochrome, cela n'a pas d'impor- 
tance ici, sauf pour certains moniteurs couleur 
à prise Péritel, reliés par un câble GS/ Péritel: 
beaucoup, datant de l'Apple Ile, ont une résolu- 
tion insuffisante pour faire un affichage propre 
en mode graphique 640 du GS. Si c'est le cas du 
vôtre, deux solutions: soit vous le bazardez 
pour acheter un moniteur couleur Apple, soit 
vous achetez un moniteur monochrome de Ile 
ou de [lc d'occasion, que vous brancherez en 
plus de l'autre. 


+ Une unité centrale, qui est l'ordinateur à pro- 
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prement parler. Elle consiste en un boîtier gris 
sur lequel est écrit “Apple II GS*. [NB: si sur 
votre boîtier, il y a en plus une espèce de 
gribouillis bizarre où on peut lire quelque chose 
comme “Woz...”, apportez-le d'urgence à Tool- 
Box pour un échange entièrement gratuit.} 
Attention: ce qui est dans cette boîte doit être un 
ordinateur Apple IIGS Roms 01 ou 03, et ce 
n'est pas toujours le cas. Pour déterminer le nu- 
méro de version de votre Rom, il suffit de 
mettre l'ordinateur en marche et de lire le texte 
qui s'inscrit avant le démarrage du lecteur de 
disquettes. Le numéro de version de Rom de 
votre Apple ICS est affiché en bas de l'écran. 
Sur un Apple ICS Rom O1, cela donne : 


0 00 0 00 0 200 oo om ee de 0 


Apple Ilgs 


Copyright Apple Computer, Inc. 1977-1987 
All rights reserved. 
ROM VERSION 01 
Le numéro de la Rom apparaît en clair sur la 
dernière ligne. Sur un Apple IIGS Rom 03, qui 
est la machine vendue à ce jour, le texte est 
identique à part que la mention ROM VERSION 
01 est remplacée par ROM VERSION 085. 


S'il n'y a pas de numéro de version de Rom, 
vous avez devant vous une pièce de musée : un 
Apple 1I1GS Rom version 0. Prenez rapidement 
rendez-vous, non pas avec un antiquaire, mais 
avec un revendeur Apple pour effectuer une 
mise à jour du précieux circuit. Ce dernier va se 
faire un plaisir de vous remplacer votre carte 
mère contre une nouvelle ayant une Rom 01 (il 
n'y a pas de possibilité de mise à jour entre les 
Roms 01 et 03, sauf en faisant l'acquisition pure 
et simple d'un Apple IIGS). Si le concession- 
naire Apple ne sait pas faire ce travail (ultra- 
simple), demandez à Apple France la liste de 
ses revendeurs à même de le faire. En désespoir 
de cause, ToolBox pourra vous sortir de cette 
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ornière, 


* Un lecteur de disquettes 3,5: retournez-le et 
vérifiez qu'il est bien écrit dessous “Apple 3,5 
Drive”. S'il y a écrit “Unidisk 3,5”, vous allez 
avoir beaucoup de problèmes, et nous vous 
conseillons d'acheter un Apple 3,5. 


+ un clavier détachable et une souris: attention, 
là souris doit être connectée sur le clavier. Si la 
vôtre se connecte sur une carte à l'intérieur du 
GS, un très grand nombre de programmes GS 
ne la reconnaîtront pas. 


+ Assurez-vous que vous avez de la mémoire 
en quantité suffisante. A l'heure actuelle, le mi- 
nimum absolu est de 1 Mégaoctet de mémoire 
vive, mais deux Mégas sont quasiment indis- 
pensables. 

+ sur les GS Rom 01, il doit y avoir une carte 
d'extension mémoire dans le slot mémoire de 
l'ordinateur. I] s'agit en général de la carte d'ex- 
tension mémoire Apple, qui au maximum est 
extensible à 1 Mo par l'adjonction de puces de 
256 kilobits; complète, cette carte possède 32 
puces mémoire. Dans le cas contraire, vous 
n'avez pas assez de mémoire. 

Je vous déconseille de compléter cette carte. 
Passez tout de suite au stade supérieur en fai- 
sant l'acquisition d'une carte d'extension mé- 
maire ayant une capacité d'adressage plus im- 
portante (4 Mégas par exemple), et mettez-y au 
moins deux mégas de mémoire. 

+ sur les GS Rom 03, il y a déjà 1 Mo de mé- 
moire soudé sur la carte mère. Le slot d'exten- 
sion mémoire est, dans la configuration de base, 
dépourvu de toute carte. Il y a là un trou à com- 
bler d'urgence ! Vous pouvez faire l'acquisition 
d'une carte mémoire extensible à 4 Mo, ou trou- 
ver d'occasion une carte d'extension mémoire 
Apple à 1 Mo (de nombreux nababs ayant muni 
leur GS de plusieurs mégas de Ram ont ce genre 
d'article dans leur placard...) Votre GS aura dès 
lors deux Mégas de mémoire. 


À partir de maintenant, je considère donc que 
vous tournez sur l'ordinateur dont il est ques- 
tion dans ToolBox Mag: un véritable Apple 
IIGS, et non pas un ZX81, ni un compatible 
Apple IT dans un Macintosh à bas prix. 


Pour être franc, il y manque encore une chose: 
un disque dur (ou un lecteur de cartouches 
genre Syquest) de 20 Mégas ou plus. Disons 
que ce genre de périphérique n'est pas indispen- 
sable pour apprendre à se servir d'un GS, mais 
seulement pour s'en servir effectivement une 
fois qu'on sait. Cela pourra donc faire l'objet 
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d'un article ultérieur. 


Ce qu'il faut jeter 


Attention ! Pas si vite ! Il vous faut aussi un sys- 
tème d'exploitation à jour. Mettez immédiate- 
ment à la poubelle les disquettes Dos 3.2, Dos 
3.3, ProDos 8, ProDos 16, MouseDesk, Système 
3.1, et Système GS/OS 4.0 (dans le lot, je vous 
conseille de vous débarrasser aussi de 
GS/WRITE). Le système à jour est le GS/OS | 
5.04. Il est en français, accompagné d'un manuel 
d'utilisation en français. Ne vous étonnez pas 
que le manuel parle de GS/OS 5.02 au lieu de 
5.04 voyez l'article de J.Y. Bourdin dans ce nu- 
méro. Avant de continuer, je vous invite à lire 
attentivement le manuel en question. Il vous di- 
ra tout sur les manipulations de base. 


Maintenant que tous ces éléments sont réunis, 
vous avez un Apple IIGS. Ne croyez pas que 
vous allez pouvoir tout de suite lancer une dis- 
quette: il faut d'abord faire de cet Apple TGS 
anonyme votre GS, Il faut le configurer. 


Le tableau de bord du GS 


Pour configurer votre GS, il faut passer par le 
Tableau de bord (ou Control Panel). II existe 
trois versions de ce tableau de bord: la première 
est en anglais el en mode texte, et se trouve 
dans la mémoire morte (Rom) du GS. C'est celle 
dont nous allons parler aujourd'hui. La seconde 
est la même que la première, mais en français. 
La troisième est un autre tableau de bord, gra- 
phique: la seconde et la troisième étant appor- 
tées par les disquettes système, nous en parle- 
rons une prochaine fois. 

Le rôle de ce tableau de bord est de pré-régler 
un certain nombre de paramètres. Le GS garde- 
ra en permanence en mémoire, même une fois 
éteint, ces paramètres dans une mémoire 
conservée avec une pile, appelée “BRam” (Bat- 
tery Ram). 

Cette pile a une durée de vie limitée : si par 
exemple votre GS se met à se comporter étran- 
gement (affichage en 40 colonnes, réglages des 
couleurs autres que ceux que vous avez choisis, 
affichage en caractères américains, clavier en 
QWERTY, pendule pas à la bonne date...) ne | 
cherchez pas plus longtemps la cause du mal 
(ce n'est pas un virus) : la pile est à changer. 
C'est peu de chose à faire, et le service technique 
de taut concessionnaire Apple est capable de 
faire cette intervention; attention quand même à 
ne pas vous faire “arnaquer” par quelqu'un qui 
vous imposerait de changer la carte-mère, ce qui | 
revient à changer la voiture quand le réservoir 
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est vide. 

Certains programmes, sans prévenir, vont mo- 
difier vos réglages dans le Control Panel pour 
des raisons de commodités de fonctionnement ; 
le problème est qu'ils oublient souvent de re- 
mettre les lieux dans l'état dans lequel ils les ont 
trouvés en entrant. Pour pallier ce genre de dés- 
agrément, vous pouvez utiliser un programme 
qui sauvegarde la BRam sur disque pour pou- 
voir la restaurer en cas de besoin. Pour cela, 
vous trouverez sur la disquette ToolBox Mag 4, 
dans le sous-catalogue /DIVERS, un petit utili- 
taire en français, Bram.Util (écrit par Jean Luc 
Darbon), qui permet de faire ce travail. Il vous 
donne aussi la possibilité de visualiser et de net- 
toyer le contenu de votre BRam des pollutions 
laissées par ces programmes sans gêne. 


Pour accéder au tableau de bord dit “en CDA” 
(en mode texte), il suffit de taper G+ Control + 
Esc., puis de sélectionner Control Panel (qui doit 
être le premier titre du menu). Nous allons 
maintenant procéder aux réglages internes de 
votre Apple IIGS en expliquant à quoi sert cha- 
cun d'entre-eux. Vous devez avoir sur votre 
écran, et donc sous vos yeux, la liste suivante : 


Display 
Sound 
System Speed 
Clock 
Options 
Slats 
Printer Port 
Modem Port 
Ram Disk 
Quif 
L'heure et la date sont affichées en haut à droite 
de l'écran dans un rectangle. 
: Dans tous les réglages du Control Panel, le petit 
repère à gauche d'une option indique qu'il s'agit 
d'un réglage par défaut. 


+ L'option Display (Affichage) permet d'indi- 
quer à l'Apple IIGS le type de moniteur qui y est 
relié : monochrome ou couleur ; le nombre de 
colonnes d'affichage en mode texte : 40 ou 80 
(en général, on choisit 80) ; puis les couleurs 
d'affichage du texte, du fond et de la bordure 
(vous êtes libre de vos choix). Le réglage Stan- 
dards permet de remettre rapidement les cou- 
leurs de réglages d'origine pour le texte, le fond 
et la bordure. 

Certains virus s'ingénient à changer ces réglages 
en réglant des couleurs impossibles à obtenir 
manuellement (par exemple affichage de texte 
noir sur un fond noir). Dans ce cas, inutile d'em- 
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mener votre GS chez le concessionnaire du coin 
pour un échange standard de la carte mère (cela 
est arrivé trop souvent}: il suffit de remettre en 
place les réglages par défaut. Pour cela, tapez 
(en aveugle si un virus de ce genre vous à 
contaminé) Option + Control + Reset. Il y a 
alors quatre choix qui se présentent : 


1 = Enter the Control Panel (accéder au Tableau 
de bord) 

2 = Set system standard and 60 hertz (réglages par 
défaut et 60 hertz) 

3 = Set systent standard and 50 hertz (réglages par 
défaut et 50 hertz) 

4 = Continue restarting the system (redémarrage 
de l'ordinateur) 


Tapez 2 ou 3 selon la fréquence utilisée ; tout re- 
devient normal... 


La fréquence actuelle de votre système est indi- 
quée en bas de l'écran quand on sélectionne 
l'option Display du Control Panel. Le système 
TV américain diffère du système européen par 
sa fréquence de rafraîchissement d'image. Celle- 
ci est de 60 hertz aux Etats-Unis pour 50 hertz 
en Europe. 60 hertz signifie simplement que le 
processeur vidéo rafraîchit l'écran 60 fois par se- 
conde ; qu'il envoie 60 fois par seconde les don- 
nées d'affichage de chaque ligne vers l'écran. La 
plupart des utilisateurs de G5, pour des raisons 
diverses, préfèrent un réglage en 60 hertz. Choi- 
sissez ce qui convient le mieux à votre moni- 
teur. 


+ L'option Sound (Son) permet de régler le va- 
lume sonore et la fréquence du son de l'Apple 
[IGS. 


+ L'option System Speed (Vitesse du système) 
permet de régler la vitesse de fonctionnement 
de l'Apple IIGS : rapide 2.8 Mhz ou normale 1 
Mhz. La plupart du temps on reste bien évidem- 
ment en vitesse rapide. La vitesse lente est 
conseillée pour utiliser certains logiciels déve- 
loppés sur Apple IL, qui ont des routines de cal- 
cul et de temporisation pointues, qui ne peu- 
vent pas être accélérées. C'est souvent le cas 
avec les logiciels protégés, les programmes de 
copie et les logiciels de communication. Cer- 
tains jeux d'arcade de l'ancien temps sont plus 
amusants en vitesse rapide. On peut aussi pas- 
ser en vitesse lente pour tricher à certains jeux 
GS ; essayez par exemple avec le jeu d'Olivier Go- 
guel de ce numéro ; cela permet de voir venir... 


+ L'option Clock (Horloge) permet de régler 
l'heure et la date du GS, ainsi que de définir les 
différents formats d'affichage. 
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+ L'option Optionspermet de réaliser un certain çon analogue. La carte d'interface du scanner à 


nombre de réglages, dont les plus importants main Quickie est de la même façon une carte in- 


sont le jeu de caractères d'affichage (français ou 


telligente. 


autre), le type de clavier (AZERTY ou autres), le Pour les lecteurs de disquettes, c'est un peu plus | 


réglage de sensibilité de la souris, le buffer 
(tampon) clavier (certains programmes plantent 
systématiquement quand ce réglage est actif, il 
est donc conseillé de le mettre sur Non) et le ré- 
glage de la sensibilité des touches du clavier. 


+ L'option Slots (Connecteurs) est vitale à com- 
prendre. En effet, le TIGS est un ordinateur qui 
est muni de slots (les connecteurs internes) afin 
d'y loger des cartes d'extension (TransWarp, 
Quickie, Carte SCSI...) et des ports (des sorties) 
permettant de brancher directement (sans carte 
d'extension) divers périphériques (imprimante, 
modem, lecteurs de disquettes...). Il faut absolu- 
ment comprendre qu'électroniquement chaque 
port est relié à un slot, et qu'il est en pratique 
difficile d'utiliser ensemble un port et un slot 
électroniquement connectés ; évidemment il y a 
des exceptions qui permettent de cumuler port 
et slot. Voici la liste des connexions entre ports 
et slots pour un Apple II GS Rom 01: 


Port imprimante = Slot 1 

Port modem = Slot 2 

Port vidéo = Slot 3 

Port souris = Slot 4 

SmartPort (lecteur 3.5") = Slot 5 
SmartPort (lecteur 5.25") = Slot 6 
AppleTalk = Slot 7 


Le réglage entre port et slot se fait à partir de 
l'option Slofs du Control Panel. C'est là que l'on 
indique à l'Apple IIGS si on utilise une carte 
d'extension dans un slot (dans ce cas, on choisit 
comme réglage Your Card) ou le port intégré 
qui lui correspond. Les deux ne peuvent pas être 
actifs en même lemps. Aïnsi, si on branche une 
imprimante ImageWriter sur le port impri- 
mante, en slot 1 il faut configurer Printer Port 
(nous verrons une prochaine fois qu'il faut aussi 
un programme pour gérer cette imprimante : ce- 
la s'appelle un driver) ; il est toujours possible 
de mettre une carte d'extension en slot 1 (par 
exemple une carte d'acquisition de données), 
mais elle ne sera pas reconnue par le système. I] 
existe cependant des cartes intelligentes qui font 
automatiquement la commutation entre le port 
et le slot. C'est le cas de la carte accélératrice 
TransWarp GS qui placée en slot 3 ou 4 ne né- 
cessite pas un réglage sur Your Card (votre 
carte) à la place de Built-in Lext display (affi- 
chage texte intégré) ou Mouse Port (Port Souris). 
La plupart des cartes stéréo fonctionnent de fa- 
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compliqué. En effet, il est possible de constituer 
une chaîne de lecteurs : lecteurs 3.5" et lecteurs 
5.25"; le tout étant connecté sur le SmartPort (le 
port disque). Pour avoir accès aux lecteurs 3.5", 
il faut donc indiquer SmartPort en slot 5 (+ un 
driver dans le système) ; de même pour les lec- 
teurs 5.25", il faut indiquer DiskPort en slot 6 (+ 
un driver dans le système). C'est sous ces deux 
conditions (réglages dans le Tableau de bord 
puis installation d'un driver adéquat dans le 


système) que votre lecteur sera pris en compte ! 
sous GS/O$. Nous verrons une autre fois com- 


ment on installe un driver dans le système. 

La situation peut être plus compliquée si vous 
avez une carte d'interface ou un disque dur in- 
terne sur carte (l'Insyder de chez Cirtech par 
exemple) en slot 6. Dans ce cas, il sera impos- 
sible de faire des copies de fichiers entre le lec- 
teur de disquettes 5.25" et le disque dur, parce 


que le premier est placé dans un slot et que le : 
second est branché sur un port qui lui est élec- 


troniquement semblable. 

C'est également à ce niveau du Control Panel 
que l'an choisit le slot de démarrage. Il faut bien 
entendu que ce numéro de slat corresponde à 
un périphérique disque. La solution la plus 
simple est de régler le Startup (Démarrage) sur 
Scan (recherche). Dans ce cas, c'est le premier 


périphérique trouvé qui démarrera (la recherche 


commence par le slot 7, puis 6, etc}. Sinon on 


peut, pour gagner quelques secondes, indiquer ; 


directement le numéro de slot sur lequel on 
veut démarrer. [Il est également possible de dé- 
marrer sur un disque Rom ou Ram. 


+ Les options Printer Port et Modem Port (Port 
imprimante et Port modem) permettent de spé- 
cifier les caractéristiques de communication 
(protocoles) entre l'imprimante et/ou le modem 
et l'Apple IIGS. Pour les périphériques Apple 
les réglages par défaut conviennent à merveille. 
Pour les périphériques non Apple, il est 
conseillé de lire les notices techniques d'utilisa- 


tion et de procéder à tâtons pour trouver les ré- | 


glages corrects. 


+ Enfin, l'option RAM Disk (Disque RAM) per- 
met de fabriquer un disque virtuel dans l'Apple 
IIGS. À toutes fins utiles, je rappelle qu'un dis- 
que Ram est une partie de la mémoire 
adressable de l'Apple HGS que l'on peut réser- 
ver afin qu'elle se comporte comme un lecteur 
de disquettes. Les temps d'accès sont bien en- 
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tendu considérablement accélérés. La partie de 
cette mémoire se comporte alors comme n'im- 
porte quel volume disque ; c'est à dire qu'elle a 
un catalogue et que l'on peut y copier des fi- 
chiers et des programmes : ils y resteront 
jusqu'à l'extinction de la machine. 

Attention, si vous voulez pouvoir booter (dé- 
marrer) sur un disque Ram ou un disque Rom, 
c'est possible. Mais il ne suffit pas de les décla- 
rer dans le Control Panel, il faut encore les for- 
mater avec le Finder. 


Quand on déclare un disque Ram, on peut lui 
allouer une taille. Cette taille, en nombre de Ko, 
est prise sur la mémoire totale disponible dont 
dispose votre Apple IIGS. Si vous ne possédez 
que 1,2 Mo de mémoire, vous ne devez pas dé- 
clarer de Disque Ram. Votre configuration est 
beaucoup trop pauvre pour tourner sous 
GS/0OS et accepter ce luxe. 

La présence d'un Disque Ram peut aussi expli- 
quer certains plantages ; de nombreux logiciels 
ont besoin de mémoire pour fonctionner et 
plantent piteusement s'ils ne la trouvent pas. 

Si vous avez un Disque Ram, il sera électroni- 
quement équivalent au slot 5, drive 2. Votre 
deuxième lecteur de disquettes 3.5" sera alors 
déplacé en slot 2, drive 1 ; ce qui provoquera 
une jolie pagaille chez les personnes non aver- 
ties. Dans tous les cas, il est conseillé de régler 
la taille minimum du disque Ram sur la même 
valeur que la taille maximum. Le contenu du 
Disque Ram n'est pas affecté par un ©+ Control 
+ Reset, c'est pourquoi vous pouvez rebooter 
(redémarrer) sur Le disque Ram (qui sera alors 
reconnu en slot 5 drive 1). Pour vider le contenu 
du disque Ram, il faut taper + Control + Shift 
+ Reset (vous avez dix doigts, non?). 


Dans la plupart des cas où vous modifiez vos 
réglages, il est conseillé de rebooter (redémar- 
rer) pour que ces réglages soient pris en compte 
par le GS (surtout les réglages concernant les 
slots). 


Et voilà: vous avez enfin un vrai GS, tout prêt à 
fonctionner. Vous allez enfin pouvoir démarrer 
votre première disquette. La seule disquette 
que vous devriez jamais démarrer, d'ailleurs: la 
disquette système. 

Pour nous, nous en resterons là pour cette fois- 
ci. D'ici le prochain ToolBox Mag, vous pourrez 
vous avancer en lisant la documentation de 
GS/0$S 5.04 et en utilisant ce système. La 
deuxième partie de l'initiation à l'Apple I GS 
sera en effet consacrée à une anatomie des deux 
disquettes système 5.04. 
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Egalité 


Avec la baisse de prix des nouveaux Macs, & 
qui n'avait pas été accompagnée d'une 
baisse équivalente sur le GS, avec Hyper- Ë 
Card livré gratuitement avec les Macs, mais 
pas avec les GS, avec comme seul nouveau & 
modèle d'Apple il une pièce de musée à & 
mettre dons un Macintosh à bas prix, les Utili- fe 
soteurs d'Apple 1! GS avaient quelque raison Ë 
d'être jaloux et d'avoir des aigreurs à l'égard Ë 
d'Apple. Nos colonnes s'en sont fait l'écho. 


Nous sommes donc d'autant mieux placés # 
pour dire de tout cœur “bravo” à Apple # 
France pour la double décision commerciale & 
qu'il vient de prendre en faveur du GS: F 


® Tous les Apple I! GS neufs vendus à partir & 
du 01/04/91 seront munis de deux Mégas de # 
mémoire (une carte mémoire Apple 1] Méga # 
remplissant ie slot d'extension mémoire), et 
cela pour le même prix qu'avant. C'est une EE 
nécessité, car les nouveaux GS seront en & 
outre livrés avec HyperCard en français, et le # 
système 5.1 en français. Fe 
Enfin, précisons: ils seront livrés avec le 5.02 et Ë 
avec un bon à remplir pour recevoir ultérieu- 
rement HyperCard et le système 5.1. Là, vous & 
ne pouvez pas rouspéter: si vous achetiez un $ 
Mac, ce serait la même chose. Hypercard à 
GS, ce sont trois manuels et six disquettes. Il & 
faut du temps, c'est normal, à la bureaucra- 
tie Apple pour faire la version française. L'es- Ë 
sontiel est bien légaité désormais rétablie & 
entre GS et Mac. : 


@ Appie connaît son monde, et a prévu les Ë 
cris des propriétaires actuels de GS: tous les & 
“utilisateurs enregistrés” d'Apple II GS peu- #; 
vent aller retirer gratuitement le bon ci-des- # 
sus chez le concessionnaire Apple le plus 
proche. Qu appelle-t-on “utilisateur enregis- & 
tré de GS? C'est simple: c'est soit un acqué- Ê 
reur du système 5.02 français. soif un abonné Ë 
ou “Guide de l Apple ll" d'Apple France. e 
Concrètement, il suffit de vous rendre chez & 
votre concessionnoire avant le 01/05/91 # 
avec sous le bras la Documentation du 5.02 & 
ou le Guide de l'Apple ll de Février 91, Ge lui Ë 
demander le “bon de mise à jour Appie Il & 
GS”, de remplir et de renvoyer aussitôt ce & 
bon à l'adresse de l'Apple Il Service Team. < 
Les concessionnaires Apple étant ce qu'ils 
sont, il peut être utile d'insister en leur don- Ë 
nant la "Référence Produit” de la mise à jour E 
Apple 1 GS: 506F6973736F6E. Sinon, essayez Ë 
un des concessionnaires de la liste donnée à 
dans le Guide de l'Apple Il. En désespoir de # 
cause, téléphoner à Apple France. 


Quoi quil en soit, même s'il est simplement À 
normal, dans le fond, de mettre ainsi le GS & 
sur un pied d'égalité avec le Mac: A 


Bravo Apple France ! 
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Le monde 


à l'endroit 


Un patch à Wings 


J.Y. Bourdin 


Dans notre numéro 3, vous avez pu lire (page 
50) de véhémentes protestations contre le 
“monde à l'envers”, l'esclavage à la Mac auquel 
voudrait nous soumettre le Wings de Vitesse, 
qui n'a pas de vrai Quit comme tout le monde. 


Rouspéter ne suffit pas à nous délivrer de l'es- 
clavage: voici donc un patch pour donner un 
Quit normal à Wings, et montrer à Vitesse que 
ses tentatives sont inutiles. Ce patch permet de 
mettre Wings où on veut sur ses disques, avec le 
nom qu'on veut, et pas forcément en /Sys- 
tem/Start, et de le lancer et le quitter comme on 


. veut: bref, il en fait une application normale. 


. À noter: les chaînes hexa ci-dessous sont va- 
: Jables pour la version 1.3 de Wings, et se fant 


sur le fichier principal de Wings, le fichier /Sys- 


| tem/Start de la disquette Wings. 


Patch simple 


: Le patch le plus simple permet que Wings ne se 
mette plus dans la pile des retours quand il 
lance Basic System depuis son bouton "BASIC" 


préprogrammé. Après avoir cliqué sur ce bou- 


: ton BASIC sous Wings, et être passé sous Basic 


System, tapez “Bye”: vous ne retournez plus à 
Wings, mais à votre lanceur précédent. Si vous 
avez mis Wings en /Svystem/Start, il sera relan- 


: cé: mais ce patch n'a de sens que pour ceux qui 
. veulent mettre Wings ailleurs qu'en /Sys- 
: tem/Start. 

. Patch: remplacer 


| 
| 
| 





[AD FA 7E 8D FC 86 22 A8 00 EI 29 20] par 
[AD FA 7E 9C FC 86 22 A8 00 ET 29 20] 


Pour les fainéants qui ne veulent même pas ta- 
per “Bye” et veulent simplement cliquer sur 
Quit, voici un autre patch, plus complet. 


Patch complet 


Le patch suivant permet de transformer le bou- 
ton préprogrammé “Finder” de Wings en un 
bouton Quit. Pour lancer ensuite le Finder de- 
puis Wings, il suffit de lui faire un bouton ad- 
hoc dans ses écrans. Ce patch comprend plu- 
sieurs temps: 


+ Remplacer la chaîne hexa 
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[AD FA 7E 8D 65 86 22 A8 00 EI 29 20] par 
[AD FA 7E 9C 65 86 22 A8 00 ET 29 20] 


+ Remplacer (quelques octets plus loin) la 
chaîne en Ascii bas f“System:Firider] par 
(9: Wings. Quitter] 


+ Remplacer la chaîne [Finder] du bouton de 
Wings par la chaîne [Quit}. 


+ Copier dans le même sous-catalogue les fi- 
chiers Start et Wings.Data du disque Wings, et 
y joindre le fichier “Wings.Quitter" de la dis- 
quette de ce numéro. Renommer Sfurt en 
Wings, et Wings est devenu une application 
normale, comme Prosel, le Finder, le lanceur de 


TransProg, ou tous les autres lanceurs. Enfin, : 


presque normale: elle se quitte simplement par 
le bouton Quit au lieu de se quitter par 5-Q. 


Si ce G-Q qui reboote au lieu de quitter vous gène, 
remplacez-le par une autre combinaison de touches 
que vous ne risquez pas de faper par inadvertance: je 
suppose que vous savez faire ce type de patch, sinon 
faîtes-le nous savair. 


Le fichier “Wings Quifter” se résume à un 
simple appel Quit P16: je ne vous mets pas le 
source! 

Ce que ça fait. 


Tout le patch se joue sur le fait que la différence 
entre un Quit avec retour ensuite et un Quit 
sans retour ensuite sont deux commandes 
CS/OS identiques, sauf sur un bit d'un para- 
mètre. Les passages patchés se liraient ainsi: 


LDA Variable 
STA ParamètreQuit 
ISL GSjOS ($SE100A8) 
$2029 ; Quit GS/OS 
EXXXX ; pointeur des paramètres de Quit 


il suffit donc de remplacer 
STA ParamètreQuit par un STZ ParamètreQuit, 
et le tour est joué. Dans le second patch, on 
change aussi le fichier désigné (fichier appelé 
Finder dans le catalogue /System du disque de 
boot, préfixe *) par le nom d'un fichier 
“WingsQuitter” situé dans le même catalogue 
que l'application (préfixe 9 de GS/OS). 
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Utilisation de l'outil de SynfhLob : 


MdSyntle Dlasger 


Jean-Pierre Charpentier 


Maintenant que l'ensemble est officiellement 
vendu par l'APDA, on s'en rend mieux compte: 
le programme SynthLab, que nous admirons 
tant, est une démonstration de toutes les passi- 
bilités sonores qui nous sont offertes par ce qui 
est le vrai programme, MidiSynth, le Tool 35. 
Avec cet Outil35, il est maintenant possible 
d'introduire dans nos programmes, avec facilité, 
des musiques de qualité tirant toute la quintes- 
sence de l'Ensoniq (ou DOC, la puce-son du GS). 


J'ai écrit le programme MidiSynth.Play comme 
un exemple d'utilisation de ce Tool35. Midi- 
SynthPlay permet simplement de charger et 
d'écouter des musiques tout en faisant varier 
certains paramètres. 


Le Tool 35 est composé de trois parties: Synthé- 
tiseur, Séquenceur, Midi. Cette dernière fonc- 
tion est volontairement laissée de côté pour cet 
exemple. En conséquence, vous n'avez pas be- 
soin du CDEV Midi. 


Pour les utilisateurs 


Pour faire fonctionner MidiSynth.Play, il faut 
bien entendu que vous avez l'ensemble logiciel 
MidiSynth: il est en vente dans le commerce. 
C'est une dépense, maïs franchement, si vous 
n'avez pas cet outil, vous ne savez pas ce que 
signifie le “S” de “GS”. 

Une fois que vous avez cet ensemble, il faudra 
commencer par mettre l'outil MidiSvnth 
(TOOL035) dans le sous-catalogue  /SYS- 
TEM/TOOLS de votre disque système, exacte- 
ment comme vous l'avez déjà fait pour les deux 
premier Tools sonores de ToolBox Mag: sans 
quoi MidiSynth.Play refusera de démarrer. Il 
faut aussi (est-il besoin de le rappeler?} que 
vous tourniez sous 5.02 minimum. 

Pour écouter les musiques SynthLab, il faudra 
également vous faire un disque sur lequel vous 
aurez copié dans le même catalogue tous les fi- 
chiers “XXX.Seg”, “XXX.Bnk" et “XXX.Wau” 
des disquettes MidiSynth. MidiSynth.Play, dans 


sa version présente, attend que ces trois {types 
de fichiers complémentaires soient dans le 
même dossier. 

I ne vous restera plus alors qu'à lancer l'appli- 
cation  MidiSynth.Play du sous-catalogue 
{Babar de la disquette ToolBox Mag 4. Tout en 
écoutant les musiques SynthLab, vous pourrez 
varier le tempo de la musique et changer le 
rythme du métronome intégré. Vous pouvez à 
tout instant arrêter la musique avec le bouton 
“[]”, et la reprendre avec le bouton “>”. Je vous 
laisse trouver tout seuls ce que fait l'option 
“changer bordure" et les boutons qui l'accompa- 
gnent. 


Pour le programmeur 


Les ressources du programme, et même le sque- 
lette de départ de l'application, ont été réalisés 
avec Genesys 1.2 (fichier DF.REZ). Attention aux 
fantaisies de Genesys avec la ressource Close (Me- 
nultem 107) si vous rajoutez un item au menu. 
Pour réassembler (assembleur APW /Orca), il 
suffit de lancer DF.MAKE. 

Le fichier source DF.SRC faisant 64k (64k juste, 
l'éditeur d'Orca/APW vous le dira), vous ne 
pourrez introduire de modifications qu'en le 
tronçonnant. Pour la même raison, ToolBox 
Mag sera sans doute incapable de le passer dans 
les colonnes de la revue. Vous le trouverez donc 
dans le sous-catalogue /BABAR de la disquette: 
je ne mets ici qu'un sommaire, un synoptique 
du programme, 


Trois points à signaler 


+ Pour arrêter la musique temporairement, par 
exemple lorsqu'on va lire une disquette, utiliser 
les appels _MSSuspend et _MSResume. 

+ Les notions de Beat et de Mesure sont entière- 
ment virtuelles (comme les barres de mesure 
dans MusicStudio). 

+ Ne pas utiliser GetMSData et _SetCaliBack 
pour une lecture simple. Ca ne sert à rien et 
consomme du temps processeur, 
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synoptique du programme MidiSynth.Play : 


Vérification de la présence du Tool35. Démarrage du Tool35 par _MSStartUp 


Sélection de la séquence par l'utilisateur “MyFile.Seq"”. 
Chargement de “MyFile.Seq”. 
Dans “"MyFile.Seq", récupération de la chaîne “MyFile.Bnk". 
Chargement de “MyFile.Bnk", 
Dans “MyFile.Bnk", récupération de la chaîne “MvFile. Wav". 
Chargement de “MyFile.Wav". 
Dans “MyFile.Seq”, récupération du Tempo. | 
Fixation par _SetTempo | 
Fixation des Tracks à jouer par _SetPlayTrack. 
Fixation de la relation Track/Channel, donc Track/Instrument, par _Trackl'oChan. 
Redirection des Tracks par _SetTrackOut (vers le synthétiseur uniquement). 
Dans “MyFile.Bnk", récupération des Instruments Records. 
Fixation par _Setlustrument. 
Dans “MyFile.Wav", récupération des PCM Data. 
Recopie des PCM Data dans la DOC-Ram par _ WriteRamBlock. 
Fixation de l'Item de démarrage dans la séquence par Locate. 
Démarrage de la musique par _SefPlayer. 


Fermeture du Tool35 par .MSShutDawn. 





Nole aux programmeurs en Genesys 
Deux points à signaler aux utilisateurs du ma- 
gnifique Genesys 1.2: 

+ Il est parfaitement possible d'éditer avec Ge- 
nesys lui-même les ressources qu'utilise par 
défaut Genesys dans l'option “New Applica- 
tion” (fichier /GENESYS/GEN.WORKYDEFAULT- 
FILE), Si ce n'est pas déjà fait, veuillez renom- 
mer votre DEFAULTFILE en DEFAULTFILEI, et 
recopier. le DEFAULTFILE du catalogue 

| (DIVERS! de la disquette ToolBox Mag 4 en | 

| IGENESYSIGEN WORK: ainsi vos applications || 

! futures diront automatiquement “Fichier” et | 

non “File”, “A propos” et non “About”, etc. 


+ Rien à faire, Genesys se bloque la touche 
Option pour ses commandes Option à lui, et 
force le clavier en américain. C'est discutable, . 
sachant qu'un des usages principaux de Gene- 
sys est précisément pour la traduction des res- 
-SOUTCES. 

En attendant une version de Genesys où ce ! 
blocage du clavier sera une option, il est 
quand même possible (et souhaitable!) de 
mettre nos caractères français dans les res- || 
sources éditables par TextEdit (avec LimeFdit, : 
ça ne marche pas). Simplement, nous voilà ra- 


: : valés au rang de vulgaires utilisateurs de Ma- 
de Jean-Piene Charpentier cimosh: il faut faire du copier-coller depuis un 
Après Le soutensmee accessoire. Cet accessoire existe, c'est l'excel- 
# lent Stricto Sensu GS d'Yvan Kænig publié 
de sa Wine j 


par le regretté Porm's. 













+ 
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{NDLR, Dans un monde informatique qui porte de plus en 
plus l'uniforme bleu, il existe des gens qui veulent mainte- 
nir le rôle de l'ordinateur comme instrument de la liberté 
des individus: ils ont souvent un Apple I GS. 

Dans un monde où les communications sont de pius 
contrôlées par d'énormes bureaucraties, entreprises ou 
armées, il existe des gens qui exercent encore leur droit 
de communiquer librement et gratuitement entre indivi- 
dus: ce sont les radioamaieurs. 

ToolBox Mag est donc un lieu naturel d'expression de 
veux qui font à la fois l'un et l'autre, et serait heureux de 
susciter quelques vocations. Vous trouverez sur la dis- 
guette ToolBox Mag 4, dans le sous-catalogue ‘RA- 
DIO AMATEURS, un fichier d'introduction générale à la 
pratique du radio-amateurisme (OM.INTRODUCTION), 
et deux fichiers d'adresses (GS AMAT et OM.ADRESSES) 
de référence. Tous ces fichiers (fichiers textes GS] sent de 
Patriek Point] 


“Your report is five nine, five nine; the QTH is Paris, 
Paris; how are you receiving me? Foxtrott Oscar five 
X-ray Zoulou, this is Foxtrott Delta one Oscar Romeo 
Foxtrott; over." 

Voilà ce que vous entendriez si vous écoutiez les ondes 
courtes où des millions de radioamateurs se retrouvent 
uniquement pour le plaisir de se dire bonjour. Dans 
l'exemple ci-dessus, un “OM” parisien explique à son ho- 
mologue tahitien qu'il le reçoit très bien (ler chiffre [1 à 
5]: compréhensibilité du message, 2ème chiffre [Q à 9]: 
force du signal). 

Mais la phonie n'est que la facette la plus connue de cette 
activité. Saviez-vous que le morse est encore utilisé par 
des milliers de fanatiques, que la Lune est utilisée comme 
un miroir pour renvoyer les ondes de l'autre côté du globe, 
que des satellites radioamateurs tournent actuellement au 
dessus de nos têtes et surtout que certains de ces passion- 
nés utilisent un Apple IGS? 


Dans toutes les possibilités offertes au radioamateur, l'or- 
dinateur peut prendre une place non négligeable. 
Ainsi, il peut se charger de la gestion du “log”: journal de 
bord obligatoire dans lequel on marque la date, l'heure, la 
fréquence et le mode utilisé pour chaque contact, Le pro- 
ramme se chargeant alors de retrouver si l'on a déjà établi 
e “QSO” (liaison radio} précédemment et d'imprimer les 
“cartes QSL” qui sont envoyées aux correspondants pour 
immortaliser chacune de ces transmissions. On pourra en- 
suite, toujours grâce à l'ordinateur, rechercher le nombre 
de pays dont on a reçu la carte ou bien rédiger un compte- 
rendu de concours en calculant automatiquement les dis- 
tances entre chaque station. 


En-dchors du GS, de quel matériel auriez-vous besoin 
pour faire de la radio amateur? 

Tout d'abord, l'organe principal est l'émetteur-récepteur, 
éventuellement un récepteur si vous n'envisagez de faire 
que de l'écoute. Un poste grandes ondes ne convient pas, il 
faut absolument un récepteur de trafic décamétrique, si 
possible à couverture générale de 1 à 30 MHz pour recc- 
voir aussi les agences de presse. 
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Le plus grand 
réseau du monde 


Patrick Pointu 





Il vous faut ensuite un modem. Il en existe autant de Lypes 
que de modes de transmission: RTTY. Packet-Radio, Fax, 
CW, Amtor… Vous pouvez aussi trouver des modems 
multimodes. Ils se branchent généralement sur une prise 
ie à cet effet sur l'émetteur-récepteur ct sur une prise 
RS-232. | 
Le radioamateurisme étant un loisir expérimental, vous | 
trouverez facilement des schémas de décodeur monomode 
ou même des kits complets pour quelques centaines de 
francs, certains étant sous forme de cartes à insérer dans 
un slot de votre Apple. 
Enfin, du côté de l'Apple HIGS, vous aurez besoin d'un lo- 
giciel de communication, On en trouve une dizaine en 
freeware ou shareware (Apr, Tic.Com, freeterm.…..}. 

| 


Une fois équipé, il vous faudra choisir votre mode de 
transmission, Îl en existe des dizaines et des dizaines, 
qu'on peut classer en trois catégories: 
+ La transmission de Ia parole: Les modes couramment 
utilisés sont la Modulation de Fréquence (FM), la Modula- 
tion d'Amplitude (AM) et la Bande latérale unique (BLU 
ou SSB en anglais). 
+ La transmission de textes écrits: Les modes sont nom- ; 
breux: La CW (le morse!}, le RTTY, le Packet Radio. : 
Baudot.. Le packet radio est le mode le plus en vogue ac- | 
tuellement dans ce type de transmission. Îl s'agit d'un déri- 
vé de Transpac adapté à la radio. Il s'est mis en place un 
réseau de BBS (Bulletin Board Systems} qui permet de 
laisser un message à n'importe quel OM du monde entier 
grâce à l'interconnexion de ces boîtes aux lettres, On peut 
aussi télécharger des programmes, lire des informations 
sur la propagation, laisser des petites annonces pour du 
matériel électronique, demander de l'aide au sujet de tel ou 
tel programme... 
C'est le plus grand réseau du monde, et c'est gratuit! 
Le seul investissement consiste à acheter un modem pac- | 
ket où bien à Le construire soi-même. Pour ce qui est du 
RTTY, vous pourrez décoder les agences de presse du 
monde entier, pourvu encore une fois que vous ayez 
lémetceur-récepteur et un mxiem ad-hoc. 
+ La transmission d'images: Pour les images fixes vous 
avez la SSTV et le Fax. Pour les images animées, vous 
avez la TVA (Télévision Amateur bien sûr!}. Là, l'Apple 
peut vous aider moyennant un interface plus complel. 

l 

| 


Aujourd'hui, la plupart des radioamateurs informalisés 
sont des galériens. De notre côté. la plupart de nos pro- 
grammes datent de l'Apple II+! Les quelques programmes 
en mode natif ne font pas le poids devant la multitude de 
logiciels pour broucttes. Mais bon sang, GS ca veut dire 
graphisme et son. La radio c'est aussi du graphisme et 
du son. Vous ne trouvez pas qu'il manque quelquechose 
entre les deux? Voilà pourquoi, quelques GSmaniaques 
ont décidé de se regrouper au sein du GSAMAT pour es- 
sayer de faire avancer lout Ça. 


Si vous avez envie d'entrer en contact avec le plus 
grand réseau du monde, contactez-nous: 

GSAMAT - cfo M. Patrick POINTO - 19. av Léopold I - 
75016 Paris. 


| 
l 






ToolBox Mag n° 4 











Made in France 





Bernard Fournier 


Breckers 


Oui mon frère, voici venir 
le RAP sur ton GS d'avenir. 
C'est super, et ça décoïffe, 


: car Breakers est super classe ! 


| Un jeu de fort belle facture, et bien dans l'air du 


temps. Deux personnages sont sur l'écran: le 
premier effectue des mouvements de RAP et 
vous devez effectuer les mêmes avec le 
deuxième personnage (à l'aide des touches 7-8- 
9-5). En fond sonore, votre outil 219 (voyez la 
dernière version sur la disquette de ce numéro) 
assurera le rythme! Le jeu est de difficulté crois- 
sante (de plus en plus de mouvements à répé- 
ter) et renouvelle donc fort intelligemment le 
style SIMON. Outre ses qualités pédagogiques 
de mémorisation et de coordination motrice, ce 
jeu est un bel exemple de programmation en 
Pascal et est disponible gratuitement. 


Francis Wolkowitch, 
4 bis rue de Lyon, 75012, Paris 


91 : l'année Liautard ? 


Tout d'abord, le mois de Janvier vit se dérouler 
à Cormeilles une réunion des passionnés du GS, 
à l'initiative de notre spécialiste ès carte Over- 
lay. Placée sous le signe de l'œcuménisme, cette 
réunion fut fructueuse à bien des égards: en 
premier lieu beaucoup de monde vit encore 
plus de monde, ce qui est en soi réjouissant. Et 
puis ce fut l'occasion de compter les nouveaux 
Maclntoshiens: à en juger par le seul Mac pré- 


sent et la frileuse poignée de ses admirateurs, le 


GS garde encore pour longtemps ses fidèles ! 
Que ce passa-t-il de notable à cette réunion en 
ce qui concerne les logiciels ? On y vit quelques 
exclusivités: Appleworks GS en cours de franci- 
sation (dictionnaire compris), HyperStudio éga- 
lement en cours de francisation (ces deux pro- 
duits devant en principe être disponibles sous 
peu). On y vit également les spectaculaires pro- 
ductions du FTA (Nucleus, Modulæ et XMas 
Demo) ainsi que la prolifique production de 
l'organisateur de ce week-end. 

Il nous présenta (outre ses charmants bambins) 
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ses dernières œuvres - gratuites - disponibles 
sur simple demande à l'adresse suivante: 


Jacques Liautard, 
13 avenue de la Libération, 
95240 Cormeilles ex Parisis 


- Horloge: cet été il sera du dernier chic de se 
promener à la plage avec son GS au poignet: cet 
utilitaire affiche en effet une magnifique horloge 
parlante. Succès garantis sur les plages ! et au 
diable la montre Helvète ! 


+ Moulisons 1.2: cet autre utilitaire permet la 
conversion des sons Hyperstudio en ressources 
pour Hypercard GS. Il permet également le 
compactage de ces sons et la modification de 
certains paramètres (volume, fréquence). Sont 
également reconnus les sons au format AE et 
RawData. 
Le menu offre une possibilité de compactage 
des images: cette option n'est pas opération- 
nelle. Enfin, bon, vous êtes au courant; alors 
ne perdez pas deux heures à chercher comment 
compacter une image avec cet utilitaire ! 


+ Point-Point: avec cet utilitaire on doit relier 
une suite de points de manière à former un des- 
sin. Ce jeu est très connu des lecteurs de maga- 
zines d'enfants: on relie les points 1 à 32 et on 
voit apparaître une figurine connue. Là c'est la 


Rectificatif 


Dans le n° 3 de ToolBox Mag, je signalais # 
dans cette même rubrique que François À 
Uhrich proposait TransProg et Fonte-D'A 
Installateur pour le même prix... Avant 
que François n'exige ma comparution de- 
vant un tribunal populaire, je tiens à lui 
présenter mes excuses et par la même occa- 


sion je vous demande la plus grande indul- 
gence: TransProg et Fonte-DA Installateur 
sont deux sharewares totalement distincts, # 
le premier pour 90 F et le second pour 60F. # 
Et ce sont tous les deux des indispen- 
sables pour tout utilisateur de GS. 


BF 
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même chose, mais sur le GS ! et bien entendu on 
peut créer soi-même ses formes à relier. Un plus 
apporté par l'informatique: les points à relier 
sont en fait le contour d'une image qui apparait 
une fois la figurine complétée. Des options per- 
mettent d'aider l'enfant dans son tracé et ren- 
dent ce logiciel utilisable même par les tout-pe- 
tits petits. 


Un grand bravo à Mr Liautard qui prépare ain- 


si des hordes de futurs passionné(e)s de l'infor- 
matique ! 


Fonction Pro 1.02 


On annonce immédiatement la couleur: c'est en 
Basic et en DHGR. 

Bien, vous êtes encore là ? Alors détaillons ce lo- 
giciel. Il permet d'entrer une fonction mathé- 


matique et de tracer automatiquement sa repré- 
sentation graphique sur un intervalle donné. On 
peut en outre modifier tous les paramètres et le 
facteur d'échelle. Bref un outil bien pratique 
pour les ‘matheux’ et qui manquait cruellement 
sur notre GS. 

Un reproche cependant: l'interface utilisateur 
est assez médiocre et la documentation un peu 
légère ne contribue pas à simplifier les choses. 
Ceci étant, cet outil est très performant et rendra 
sûrement d'immenses services à pas mal de po- 
taches. 

Ce logiciel est également gratuit et est dispo- 
nible auprès de: 


Mr Rondof Jean-Paul, 
11 rue du Frais Foyer, 
49000 Angers. 





Un jeu en six versions : 


Fun Beyond GS 


Olivier Goguel 





Bon, ce ne sont quand même pas ces satanées consoles qui vont nous empêcher de 
nous continuer à nous amuser avec notre GS! Puisque la production de jeux par les 
“Big Companies” est un peu en baisse en ce moment, le FTA et ToolBox Mag pren- 
nent la relève. Ayant vu passer furtivement l'idée sur une brouette (il semble que 
l'idée de départ vienne d'un jeu sous Unix de J.Geertson appelé “xcolumns”), nous 
avons décidé de l'implanter sur une machine pour les grands. 


Le principe du jeu est une variante de Tetris: au lieu d'entasser des blocs de façon à 
boucher les trous, on prend des figures composées de trois blocs carrés de couleur. 
Ces blocs, une fois tombés, s'effacent dès que trois d'entre eux de la même couleur 

_ sont alignés, selon les règles du morpion (alignement horizontal, vertical, diagonal 
dans les deux sens). Du coup, les blocs qui sont au-dessus tombent dans les trous 
ainsi dégagés, par “gravité”: éventuellement, ils disparaîtront alors à leur tour, par 
réaction en chaîne. 


On ne peut pas, comme dans Tetris, faire pivoter la figure, mais on peut inverser 
l'ordre des blocs (touche R). La touche N permet d'afficher la pièce suivante. Un 
. “Help” intégré vous dira tout ce que avez à savoir pour jouer à Fun Beyond GS. 


Originalité, Fun Beyond GS est proposé en versions anglaise et française, et sous 
trois formes à chaque fois: application Prodos 8, application GS/OS, CDA. Vous choïi- 
sissez votre version à l'assemblage, qui se fait directement en une seule fois. Evi- 
demment, c'est avec Merlin 16 qu'on fait tout ça! Vous trouverez le source complet 
sur la disquette, catalogue /BEYOND), sous-catalogue /BEYOND. SOURCE. 








Page 34 


ToolBox Mag n° 4 





[NDLR: Nous n'avons pas la place dans la revue pour imprimer le source entier d'Olivier. Vous 
le trouverez donc dans le catalogue /BEYOND de la disquette ToolBox Mag 4. Vous pourrez ainsi 
rajouter à Beyond GS l'acceptation des minuscules du clavier, par exemple. Mais nous tenons à 
imprimer une routine, marginale par rapport au jeu, mais particulièrement intéressante: Olivier 
s'y est battu avec GSJOS pour lui faire faire ce qu'il voulait lui, et non ce qu'Apple avait prévu. 


Et devinez qui a gagné ? 


Il nous semble en revanche qu'Olivier s'est inutilement battu avec P8 pour le chemin d'accès de 
son programme: à notre connaissance, le chemin d'accès complet d'une application SYS qui 
vient de se lancer est toujours en 00/0280 et la suite. Quelqu'un sait-il si c'est juste une habitude, 


ou si cela est garanti par le Bureau Politique?] 


Dans tout ce programme, nous allons -comme d'habitude- 
tout gérer par nous mêmes (affichage, gestion des er- 
reurs, etc). Malheureusement, nous allons être légère- 
ment gênés par GS!OS, qui a la possibilité d'afficher des 
fenêtres de dialogue (texte ou graphiques) pour nous 
avertir de l'apparition d'erreurs éventuelles. Théorique- 
ment, l'appel SetSysPref permet de dire à GS'OS de ne 
pas s'occuper de la gestion des erreurs: 


JSL SE100A8 

DA $200F GetSysPref 
ADRL SysDefaul(Parms 

JSL $E100A8 

DA $200C SetSysPref 
ADRL SysParms 


Mais en fait, dans certains cas, GSIOS va -malgré les pré- 
férences demandées- afficher certaines fenêtres d'erreurs: 
ce qui serait fatal à notre application aussi bien qu'au 
système, dont la cohabitation est impossible hors des li- 
mites définies par. votre serviteur ! 

Nous sommes alors obligés de patcher GS'OS, sans scru- 
pule, puisqu'aucun appel homologué ne permet de faire 
éxactéement ce que nous voulons. On ne va tout de même 
pas se laisser dominer par un système d'exploitation quel- 
conque…. 

J'ai donc “examiné” une partie de GSiOS pour remonter 
jusqu'à la routine qui m'intéresse: celle-ci se trouve poin- 
tée par un vecteur (dont l'adresse, quoique non déclarée, 
me paraît inamovible) en $01FC98. 

Si on suit ce qui est pointé par ce vecteur, an trouve un 
bout de routine qui commence par : 


r LSR 

si BCS AfficherFenctre 

*+ LDAL $00B9F6 Test des préférences 
Le BMI AfficherFenetre (Bit15=Affichage) 
* 

e RTL 

* Aff_Fenctre … 


GS/OS, Tais toi! Un extrait du source de 
Fun Beyond GS, par Olivier Goguel 





BCS ne soit jamais pris, et ainsi on n'aura jamais de fe- 
nêtres indésirables à l'écran. 

Nous enlèverons notre patch au moment de quitter, bien 
entendu. En attendant, c'est notre application qui gérera 
les erreurs,en l'absence de tout message GSIOS fen parti- 
culier du message “Insérez le disque XXX"]. 


SEP $20 

LDAL SE1C068 
PHA 

LDAL SEICUS8B 
LDAL SEICO8B 


REP $30 


LDAL SOIFC9I8 
AND #$00FF 
CMP #85C 
BNE NoPatch 


LDAL $01FC99 

STA SaveVect+! 
LDAL $OIFCIA 
STA SaveVect+2 


LDA New Vect+] 
STAL $01FC99 
LDA NewVect+2 
STAL $01FCIA 


SEP $20 

PLA 

STAL $E1C068 
REP 530 


BRA Continue_Init 


On vérifie que c'est 
bien un vecteur. 


Sauvegarde de 
la valeur du vecteur 


et détournement 
vers notre rouline 


NoPatch 


SysDcfaultParms DA 1 Sauvegarde 

DA 0 des préférences 
SysParms DA 1 

DA Q GSIOS, tais-toi ! 


NewVect  JML NewFC98 nouvelle valeur FC9S 


On voit bien le BCS qui peut forcer l'affichage d'une fe- | NewEC98 LDA £0 


nêtre malgré l'état du drapeau Préférences... 
Nous allons donc détourner le vecteur en S01FC9S vers 


SaveVect JML SKKIOOQ Ancienne valeur FC9S 


une routine qui remet l'accumulateur à 00, pour que le (La suite sur la disquette.) | 
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Ce qu'il faut savoir 


HyperCard GS (Apple 
Computer) : compléments 


C'est pendant la dernière Ap- 
pleFest qu'Apple à officielle- 
ment présenté la version cou- 
leur d'HyperCard. Ralph Russo 
lui même a fait une brillante 
démonstration du puissant lo- 
giciel hypermédia. 

HyperCard GS est un produit 
Apple et non pas un produit 
Claris. Il est disponible depuis 
le 15 Février auprès de tous les 
revendeurs Apple. L'ensemble 
est composé de six disquettes 
et trois manuels. Une des dis- 
quettes contient le programme 
proprement dit et la pile 
HOME. Une autre contient une 
pile d'aide ; l'aide dans Hyper- 
Card est très bien faite : elle est 
très détaillée et explicite dans le 
fonctionnement du pro- 
gramme. Les autres disquettes 
contiennent des fichiers de 
commandes externes 
(XCMDS), des fichiers de fonc- 
tions externes (XFCNS), un édi- 
teur d'icônes, un éditeur de 
sons. 

Le produit final est livré avec 
trois manuels de référence : 

1) Débuter avec HyperCard GS, 
2) HyperCard GS Référence, et 
3) Le manuel HyperTalk (le 
langage de programmation 
d'HyperCard). 

Aux USA, HyperCard GS n'est 
pas livré avec les configura- 
tions Apple II GS neuves, car le 
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CS News 


Eric Wevyland 


programme a absolument hbe- 
soin de 1,5 Méga de mémoire et 
d'un disque dur pour tourner. 
HyperCard GS est livré avec le 
système d'exploitation GS/OS 
version 5.04. 

C'est en fait un HyperCard 
Mac version 1.2.5, mais avec 
des enrichissements considé- 
rables (la couleur, mais aussi la 
gestion de data en base de don- 
nées, etc}. 

HyperMover (une pile Macin- 
tosh et une pile Apple I1GS, 
encore en version bèta pour le 
moment) sera distribué ulté- 
rieurement en version défini- 
tive par l'APDA. Il permet de 
décompiler des piles Iyper- 
Card Macintosh en les transfor- 
mant en fichiers intermédiaires. 
On peut alors transférer ces fi- 
chiers intermédiaires sur Apple 
II GS pour reconstituer une pile 
HyperCard GS. Ce procédé 
n'est pas très rapide, et il faut 
disposer à la fois d'un Macin- 
tosh et d'un Apple 11GS, car 
HyperCard GS ne peut pas lire 
directement les piles venant du 
Mac. Si la pile Macintosh fait 
appel à des commandes ou à 
des fonctions externes, celles-ci 
devront être ré-écrites ou re- 
compilées sur Apple II GS. 
HyperMover n'est en fait utile 
que pour les piles Mac conte- 
nant beaucoup de programma- 
tion HyperTalk, car de toute fa- 
çon l'interface utilisateur est à 
refaire, ne serait-ce que pour la 
couleur. Ce qui se profile en 
fait, et qui est beaucoup plus 





































intéressant, est le développe- 
ment simultané, dès la concep- 
tion, de piles à la fois pour Mac 
et pour GS. 
Publicité : 
Apple a les moyens 


Quand Apple veut faire savoir 
quelque chose cela ne passe pas 
inaperçu. C'est plus de 40 
millions de dollars qui ont été 
investis pour promouvoir le 
nouvelle gamme de Macintosh. 
Cela a porté ses fruits car il y a 
déjà des ruptures de stocks sur 
ces modèles ; les revendeurs 
Apple en manque de Macs 
pourraient en profiter pour es- 
sayer de vendre des Apple 
IIGS plutôt que des gamelles 
compatibles IBM... 


GS/OS 5.04 
(Apple Computer) 


Le système 5.03 ayant été retiré 
de la vente car le driver 
d'ImageWriter avait des fai- 
blesses sur des configurations 
pauvres en mémoire, c'est le 
système 5.04 qui est le dernier 
système en date aux Etats-Unis, 
(pour la France, voir page 4). 
Pour avoir la version US, il suf- 
fit d'acheter HyperCard ou Ge- 
nesys 1.2. 


Poisson 8 bits 


Voici quelques crouslillantes 
particularités de la carte d'ému- 
lation Apple Ile destinée par 
Apple à boucher l'unique slot 
du tout nouveau Macintosh à 
bas prix. Cette carte ne peut 
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pas reconnaître plus de 1 Méga 
de ram (le LC de base a 2 Mé- 
gas en ligne) ; la raison invo- 
quée est que les cartes d'exten- 
sion Apple pour Apple Ile n'ont 
jamais dépassé cette limite! 
Cette carte peut être configurée 
en 1 ou 2 mhz ; le programme 
fourni avec la carte fera une 
pseudo gestion de slot par si- 
mulation logicielle. Il est pos- 
sible d'y connecter un joystick, 
un lecteur 5,25 et bien sûr un 
lecteur 3,5. Disponibilité Avril 
1991: c'était donc un poisson ! 


Broderbund Software : 
Pas dans le coup ! 


Cette très réputée société d'édi- 
tion américaine vient de déci- 
der de ne pas sortir de version 
Apple II GS de Prince of Persia 
qui est le must du jeu d'arcade- 
aventure sur les Apple 8 bits. 
Influence rétro d'Apple? 


Harmonie : L'imageWriter 
fait bonne impression | 


La série de drivers d'impri- 
mantes éditée par la firme Vi- 
tesse contient un driver pour 
ImageWriter Il tout à fait per- 
formant : c'est une nouvelle 
version de celui qu'évoquait 
Jean-Yves Bourdin dans le nu- 
méro 1 de ToolBox Mag. Ce 
driver a été écrit par Bill Heine- 
man. 


Dragon Wars : 
Pas anonyme... 


L'auteur de Dragon Wars (voir 
numéro précédent) n'est pas un 
inconnu : il s'agit de Bill Heine- 
man, l'auteur de différents dri- 
vers. Cet homme est très occu- 
pé : il s'occupe de très près du 
magazine GS+, il vient de ter- 
miner un petit jeu pour ce 
même magazine (Night of the 
living Macs : le but du jeu est 
de tirer sur des Macintosh afin 
qu'ils tombent dans l'oubli...) il 
travaille pour Vitesse (Harmo- 
nie}, et est employé à temps 
complet par InterPlay (l'éditeur 
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de Dragon Wars). Bill projette 
d'écrire deux nouveaux jeux 
pour Apple IIGS FufureWars 
GS et James Bond Sfealth Affair; 
InterPlay attend de voir ce que 
va rapporter Dragon Wars GS 
avant de donner son feu vert... 


Genesys : 
y a de la ressource | 


Le plus performant des édi- 
teurs de ressources est mainte- 
nant livré dans sa version 1.2, 
sous GS/0O$ 5.04. Vous en en- 
tendrez souvent parler dans 
ToolBox Mag: c'est vraiment un 
achat à envisager. 


Roger Wagner : 
chômage ? 


L'éditeur d'HyperStudio, le 
premier système hypermédia 
sur Apple II GS, n'est pas trop 
inquiet de la concurrence que 
va lui faire HyperCard. Il fi- 
gnole son produit porteur en le 
dotant de diverses extensions : 
des commandes externes pour 
exécuter à partir de HyperStu- 
dio des programmes écrits 
dans divers langages (il existe 
pour le moment 18 XCMDS 
pour HyperStudio dont une 
qui permet de jouer des musi- 
ques de type SoundSmith}, des 
clip-Art, et des clip-Sounds. 
Durant l'AppleFest, HyperStu- 
dio a fait grande impression. 
En effet, le programme contré- 
lait l'action d'un jeu vidéo inté- 
ractif : Dragon's Lair. Le tout 
tournait sur Apple I GS, muni 
d'un lecteur de disques opti- 
ques et d'une Overlay Card. A 
l'avenir, les fanatiques du joys- 
tick vont devoir investir pour 
pouvoir se défouler sur leur 
Apple Il GS. 


Trophées AppleFest : 
les meilleurs produits 
américains du moment 


Un jury s'est réuni durant la 
dernière AppleFest US pour at- 
tribuer des trophées. Ce jury 
était constitué de représentants, 


des magazines : A+/Incider, 
A2-Central, GS+ Magazine, 
Nibble, d'Apple Computer, : 


d'America On-Line, de Compu- ; 
serve, et de GEnie. Plusieurs 
catégories ont été prévues pour 
l'attribution des trophées. Voici 
les résultats : 


Meilleur programme éducatif: 
Katie's Farm 

Meilleur programme Apple II 
(8 bits): Proterm 2.2 

Meilleur programme Apple 
I GS (16 bits): HyperStudio 2.1 
Meilleur programme Freeware 
ou Shareware : Shrinklt GS 
Meilleure innovation : 

Ramfast SCSI 

Meilleure réalisation multimé- 
dia : HyperStudio 2.1 

Meilleur outil de développe- 
ment ou langage de program- 
mation : Genesys 1.2 

Meilleur utilitaire de débug- 
ging : GSBug 1.5 
Meilleur périodique 
l'Apple Il : A2-Central 
Meilleur serveur : 
America On-Line 
Hardware de l'Année : 
Carte SCSI High Speed DMA 
Programme de l'année : 
HyperStudio 2.1 


sur 


Une mention spéciale du jury a 

été décernée à Appleworks 3.0. | 
Il serait temps de faire une Ap- 
pleFest mondiale, histoire de 

produits 

. 


faire concourir les 


français… 
Suprême (Vitesse) 


C'est sous le nom de Suprême 
que l'ensemble des pro- 
grammes de chez Vilesse sont 
regroupés pour être vendus en 
lot. Il s'agit de : Salvation, Ren- 
naissance, Éxorciser, Wings et | 
Deliverance. 


Au fait, savez-vous pourquoi | 
Vitesse tient à donner ainsi des 
noms français à ses produits? 
Eh bien, d'une part, c'est du 
dernier snabisme aux USA en 


1 


ce moment. D'autre part, un. 


Page 3/7 








mot anglais sur deux aux Usa 
est une marque déposée. On va 
donc piocher chez nous: bref, 
ils font comme ToolBox, mais 
dans l'autre sens! 


le Fard 


Zip Chip GS : 
mauvaise nouvelle 


Cette carte accélératrice, n'est 
dans son état actuel, toujours 
pas totalement compatible avec 
AppleTalk. Fâcheux.. Une 
bonne nouvelle quand même : 
un co-processeur arithmétique 
serait en cours de développe- 
ment pour cette carte. D'autre 
part, Zip Technologies fait de 
bonnes affaires : tout leur stock 
de Zip Chip GS a été vendu du- 
rant l'AppleFest. 


Lecteurs Æ 3,5 
et Æ High density 
(Applied Engineering) 


Selon Phil Monloya d'Applied 
Engineering, deux nouveaux 
lecteurs de disquettes sont 
maintenant disponibles. Il 
s'agit d'un lecteur 800k (Æ 3,5) 
destiné à concurrencer le lec- 
teur Apple, et d'un lecteur 
haute densité 1600k (Æ High 
density). Il est possible de 
transformer un lecteur Æ 3,5 en 
lecteur Æ High density par un 
simple remplacement de circuit 
intégré (et par l'adjonction d'un 
autocollant HD sur la face 
avant du lecteur...) 

L'avantage du lecteur haute 
densité, outre sa double capaci- 
té, est son aptitude à pouvoir 
accepter les disquettes 
MS/DOS haute densité quand 
on le branche sur une PC 
Transporter. Attention ! Pour 
utiliser ce lecteur haute densité 
sur un Apple II GS, il est néces- 
saire d'utiliser un driver, à pla- 
cer sur votre volume de boot. 
Ce driver est fourni avec le lec- 
teur, et prend la place du dri- 
ver Apple, fourni avec le 
GS5/05, chargé de la gestion du 
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lecteur Apple 3,5. 

Ce nouveau driver est capable 
de gérer les lecteurs Apple, de 
façon plus rapide : ainsi des 
configurations ayant ces deux 
types de lecteurs sont parfaite- 
ment envisageables, Ce nou- 
veau driver fonctionne sous 
ProDos 8, maïs il faut charger 
GS/OS au préalable. Un boot 
direct sur ProDos 8 ne fonc- 
tionne pas avec le lecteur Æ 
High density. 

Voici les formats reconnus par 
ses nouveaux lecteurs : au for- 
mat ProDos exlusivement - 800 
Ko 2:1 - 800 Ko 4:1 - 400 Ko 4:1 
- 1600 Ko 2:1 - 1600 Ko 4:1. Des 
FST (File System Translator) 
pour Macintosh ou MS/DOS- 
beurk ne sont pas disponibles, 
et ne sont pas prévus. 

Selon Æ, cela est dû aux limita- 
tions du circuit de l'Apple II GS 
contrôlant les lecteurs de dis- 
quettes (WM : Integrated Woz- 
niak Machine). Le lecteur haute 
densité ne fonctionne que sur 
Apple IIGS ; il ne fonctionne 
pas sur les Apple 8 bits. 

D'ores et déjà, Prosel 16 recon- 
naît ce lecteur pour faire ses 
back-ups. 

Avec ce lecteur Æ, et la baisse 
du prix du lecteur Apple simi- 
laire, l'argumentation d'Yvan 
Kænig dans ToolBox Mag 2 ne 
tient plus tout à fait. Reste 
quand même que, si vous avez 
besoin d'un lecteur de dis- 
quettes de plus grande capacité 
pour le GS, vous avez intérêt à 
comparer avec un Syquest, et 
avec les lecteurs 3,5 haute den- 
sité SCSI dont nous vous parle- 
rons dans un prochain numéro. 
Rappelons qu'une disquette 3,5 
1600k Haute Densité est la 
même qu'une disquette 800k, 
mais avec un deuxième trou, à 
droite, Vous avez donc compris 
comment vous faire des dis- 
quettes 1 600k. Attention, ce- 
pendant, ces trous doivent être 
carrés pour être reconnus par 
les lecteurs Haute Densité, Une 


simple perceuse à mèche carrée 
suffit. Contactez Hubert Loise- 
leux à ToolBox si vous n'en 
trouvez pas chez votre quin- 
cailler. 


SendFax (Applied 
Engineering) : un fax dans 
votre Apple Il GS 


Là aussi, il s'agit d'un matériel 
qui fonctionne exclusivement 
sur Apple II GS. I s'agit d'une 
série de circuits électroniques 
venant en complément des mo- 
dems Datalink Express et Data- 
link GS. Un programme est 
fourni ; il permet d'accéder aux 
possibilités de télécopie. C'est 
en fait un driver de modem 
que l'on peut sélectionner dans 
le Control Panel graphique. 
Quand vous êtes dans votre ap- 
plication, composez votre mes- 
sage, et faîtes une impression. 
1! est alors possible d'entrer un 
numéro de téléphone. Le mes- 
sage est ensuite envoyé sur la 
ligne téléphonique via le mo- 
dem. 


Attention, donc, ce n'est pas un 
fax complet: ça envoie, mais ça 
ne reçoit pas. Pour ses fax, 
ToolBox a... un fax, tout sim- 
plement. Dédier un ordinateur 
à un fax ne se justifie que pour 
qui fait, pendant la nuit, aux 
heures creuses, du mailing par 
fax (oh, si, c'est courant, hé- 
las!). 


Enhanced Vision Plus 
(New Concepts) : 
Réincarnations 


C'est une carte permettant de 
digitaliser des images à partir 
d'une source vidéo. Elle portail 
préalablement le nom de Visio- 
nary GS (Virtual Realities a 
disparu dans la nature), et à 
l'origine le nom de carte AST. 
Cette carte renaît donc de ses 
cendres. En fait, c'est le pro- 
gramme qui accompagne la 
carte qui est remarquable. Il a 
été écrit par Scott Gentry et 
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Jonash Stich. Il fonctionne en 
mode couleur dithering. Avec 
ce matériel, il faut environ 7 se- 
condes pour capturer une 
image couleur. Il est bien en- 
tendu possible de faire de la di- 
gitalisation en monochrome. 
En prime, si vous faîtes l'acqui- 
sition de ce matériel, vous au- 
rez droit à un programme ap- 
pelé Allison 3200 qui permet de 
faire des conversions en images 
3200 couleurs. 


LS soft: les jsux 


Cryllan Mission 
(Victory Software) 


Pour ceux qui ont eu la pa- 
tience de terminer Cryllan Mis- 
sion, Victory Software vient de 
sortir un deuxième scénario. Le 
jeu est toujours en mode desk- 
top. 


LS soft: lss uiiliaires 


BannerMania 
Broderbund Software) 


Nouveau programme de la so- 
ciété californienne tournant sur 
tous les Apple IE Il permet 
d'imprimer toute sorte de ban- 
deroles. A défaut d'imprimante 
sur tissu, Ça ne peut pas faire 
les manifs, mais cela permet de 
grandes  banderoles papier 
pour une vitrine de commer- 
çant, par exemple. 


Photonix |! Toolbox) : 
version 2.30 


Cette dernière version règle 
différents problèmes d'éjection 
de disquettes ; la fonction anti- 
virus traite le virus Apoca- 
lypse. 


Desktop Screen Saver 
(Roger Wagner Publishing) 


Voici un autre NDA produit 
par Roger Wagner (le premier 
est Desktop File Control). Celui 
ci permet de capturer des 
images ou des portions d'image 


phique puis de les sauvegar- 
der. On peut fixer un délai, de 
façon à sauver un écran avec 
menus déroulés, par exemple. 
Tout ça ne me semble guère 
vraiment nouveau... 


Clip Art Volume 2 
Roger Wagner Publishing) 


Voici une collection de 500 
images à utiliser dans Hyper- 
Studio (ou ailleurs), Tous les 
thèmes sont présents : les ani- 
maux, les visages, les construc- 
tions, la nature, les bombes et 
les missiles Aussi incluses, 
des images avec des boutons et 
des bordures. 


Golf Teacher 
(FYI Publishing) : 
HyperStudio joue au golf 


Voici la première pile commer- 
ciale pour HyperS$tudio. Cette 
pile permet d'apprendre à jouer 
au golf. Elle est constituée de 
cinq disquettes 3,5. La pile uti- 
lise des graphiques et des ani- 
mations. L'hypermédia permet 
ainsi de pallier les insuffisances 
des démonstrations littéraires. 
Cette pile commerciale met en 
lumière un avantage certain 
d'HyperStudio par rapport à 
HyperCard : l'existence d'un 
runtime gratuit permettant de 
lire les disquettes sans avoir à 
acheter Hyper$tudio. 


Chinook Utilities 


La dernière version des utili- 
taires Chinook (absolument né- 
cessaires pour travailler avec 
un disque dur SCSI) esi la 1.5. 
Elle est capable de reconnaître 
les disques durs à cartouches 
amovibles, et les deux versions 
de la carte SCSI Apple (Rom C 
et DMA High Speed). 


Le soft: freswars 
el Sherswars 


Fonds de tiroirs 
(Beagle Bros) : 


Les programmes suivants sont 
désormais gratuits ; c'est le der- 
nier catalogue Beagle Bros qui 
l'annonce : Alpha Plot - Beagle 
Bag - Beagle Basic - Dos Boss - 
Big U - D Code - Double Take - 
Extra K - Fat Cat - Flex Type - 
Font Mechanic - Frame Up - 
Pro Byter - Pronto Dos - Shape 
Mechanic - Silicon Salad - Tip 
Disk 1 - Utility City. 

Ces programmes sont sur Ge- 
nie accompagnés de leurs do- 
cumentations. 

Aux anciens de l'Apple IL, ces 
titres vont rappeler le temps où 
ils bidouillaient sur leur 24. 
Les utilisateurs du poisson 
d'Avril Apple pour Mac à bas 
prix seront contents aussr leurs 
logiciels sont tellement périmés 
qu'ils sont gratuits! 


Columns (Kenrick Mock) 


Le principe du jeu est le même 
que Fun Beyond GS d'Olivier 
Goguel dans ce numéro. Il faut 
aligner des blocs de couleurs 


en essayant de faire des lignes 
de trois. Une fois qu'une ligne 


est formée, elle disparaît. 


ToolBox Mag publie ce jeu en: 


CDA, S16 et SYS; Columns est 
en mode desktop, et en share- 
ware ce qui n'est pas le cas des | 
autres. Je me doute que vous 


n'êles pas prêts de l'acheter, 
puisque vous avez l'autre. A 
mon avis, la version FTA est 
très supérieure. Mais enfin, si 
vous voulez comparer par 
vous-même... 


À lire 
GS + (Ego System) : 
précision importante 


Cette nouvelle revue est 
d'Outre Atlantique : j'avais ou- 


blié de le mentionner dans le : 


numéro précédent. 

C'est bien le seul vrai confrère 
de ToolBox Mag, mais il ne 
projette pas dans l'immédiat de 
version française, hélas. 


| 


se trouvant sur l'écran gra- les classiques gratuits ! 


ToolBox Mag n° 4 


Page 39 








Un générateur d'écrans et fenêtres texte en 80 colonnes sous P8 : 


GE 80 


Un nouveau générateur ou éditeur d'écrans, ce n'est 
pas trés original, il en existe de nombreux. Oui, mais 
ils sont, en général, rustiques, peu conviviaux et ne 
permettent pas l'utilisation des caractères mousetext. 
Celui-ci pourrait être un peu l'aboutissement du 
LE grâce à sa facilité d'emploi, à la richesse de ses 
onctionnalités et, surtout à sa capacité de créer des 
fenêtres d'écran et de les sauvegarder avec leurs di- 
mensions. 

I s’agit d’un outil principalement destiné à ceux qui 
s'adonnent à la programmation en Basic Applesoft, 
Pascal, Assembleur etc.. Il est entièrement dévelop- 
pé en Assembleur 65C02, ce qui lui confère une fiabi- 
lité et une vitesse incomparables. 


A quoi sert GE 80 ? 


À générer des écrans texte en 80 colonnes débarras- 
sés des fameux ‘trous d'écrans’ et récupérables dans 
n'importe quel environnement P8, de façon instanta- 
née, grâce à un module de chargement relogeable se- 
lon les règles de Prodos. Il peut être aussi utilisé 
comme ‘bloc-notes’ et utilitaire de ‘gestion disque’ 
en-dchors de toute notion de programmation. GE 80 
avec, en particulier GE.TOOLS, peut être considéré 
comme un éditeur de ressources. 


GE 80 comporte deux principaux segments consti- 
tuant l'architecture du fichier GESYSTEM et qui 
sont décrits ci-après: 


Un éditeur d'écrans et fenêtres : GE.EDIT 


Le segment ‘éditeur d'écran’ apporte à GE 80 des 
fonctionnalités proches de celles d'un traitement de 
texte, mais limitées à un écran ou à une fenêtre. On 
peut écrire en mode normal, inverse et utiliser les ca- 
ractères mousetext, ce qui permet de générer des 
écrans au ‘look’ moderne (cadres, boîtes, flèches etc. 
à l'instar de Prosel} et de simuler des environne- 
ments du type ‘desk’ en mode texte, pour une ex- 
ploitation de la souris. Il offre à l'utilisateur toutes 
sortes de commandes très pratiques telles que: 


+ déplacement rapide du curscur mot par mot et 
dans les deux sens, 

» insertion de caractères ou de lignes, 

* suppression de caractères, de lignes ou de portions 
de ligne, 

+ tabulateur au pas de 5 caractères, 

+ écriture sur écran en vidéo inverse, 

+ accès direct aux caractères mousctext, 

° conversion majuscules / minuscules, 

+ conversion affichage normal / inverse, 

+ écriture verticale, 

+ copie de lignes ou segments de lignes en insertion 
ou écrasement, 

I! fournit 4 possibilités d'environnement de travail: 
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+ écran/cadre avec barre des commandes en bas 
d'écran, 

+ plein écran avec barre des commandes, 

+ plein écran sans aucune aide, 

+ éran/cadre, sans barre des commandes. 


On peut, de plus, lorsque le cadre est affiché, faire 
apparaître, en haut de l'écran, une règle de tabula- 
tion facilitant le repérage lorsque la barre de com- 
mande n’est pas présente, 
La barre de commande affiche les coordonnées du 
curseur, le mode d'affichage, auquel est associé un 
» de curseur, et le mode d'écriture. 
Le nombre de commandes étant élevé, l'utilisateur 
peut à tout moment, sans altérer le travail en cours, 
afficher des écrans d'aide donnant la liste et la signi- 
fication des commandes et le tableau de correspon- 
dance entre les caractères ascii et mousctext. 
Autre fonctionnalité intéressante: GE 80 permet de 
conserver en RAM deux versions d’un écran de tra- 
vail. Deux tampons de la mémoire ont été réservés à 
cet effet. Lorsqu'on sauve sur disque la version affi- 
chée, celle-ci se projette automatiquement dans l'un 
des tampons sans altérer la précédente version, ce 
qui permet de récupérer à tout moment l’une ou 
l’autre version par -R. 
Note technique : la mémoire-tampon principale est située 
à l'adresse $4000 et sert à la récupération de tout écran ou 
fenêtre pour les opérations d'entréeisortie (sauvegarde, af- 
fichage, impression efc..). La mémoire-tampon secondaire 
est à l'adresse $D400 enr ‘bank 2° de la ‘bank suritched me- 
mory' (carte langage) en mémoire auxiliaire. 
ll est également offert la possibilité de dupliquer 
l'écran affiché à l'aide de Option-W et de pouvoir 
ainsi le modifier sans perdre la version précédente 
en cas de remords. La récupération s'opère par un 
processus de bascule à l’aide de la commande 5-R. 
De façon générale, la majorité des commandes est ac- 
cessible par des séquences G ou Option. 


GE-SYSTEM comporte également des fonctions 
d'impression d'écran: 

+ G-P ou Option-P imprime l'écran sauvegardé dans 
la mémoire-tampon principale 

° -H ou Option-H réalise un ‘hard copy’ de l’affi- 
chage. Cette fonction cst disponible dans la plupart 
des niveaux de menus. 

Ces fonctions ne sont effectives qu'avec une impri- 
mante ImageWriter Il en raison de l'utilisation des 
caractères graphiques-souris que seule celle-ci est ca- 
pable d'imprimer. 

Deux types d'impression sont disponibles: 

+ pica standard en qualité brouillon, 

» qualité supérieure avec caractères demi-hauteur. 
Ces deux types sont sélectionnés par -S, G-H ou 
Option-S, Option-H. 

En outre il est possible de sélectionner la couleur 
d'impression dans GE.CONFIG. Cette option n'est 
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active qu'avec une ImageWriter Il et un ruban cou- 
leur. 


Enfin, et c’est l'une des plus grandes originalités de 
GE 80, on peut créer toutes sortes de fenêtres avec 
ou sans cadre et les sauvegarder avec leur dimen- 
sion. La majorité des fonctions d'édition décrites 
plus haut sont disponibles en mode fenêtre. Les fe- 
nôtres peuvent être déplacées verticalement et hori- 
zontalement grâce aux commandes G -> et CG <- pour 
rechercher leur position optimale sur l'écran. Îl est 
possible d'opérer des superpositions de fenêtres en 
utilisant alternativement la commande G-R. 


Un gestionnaire de disques : GE.DSK 


C'est probablement la partie de GE 80 la plus intéres- 
sante car elle constitue la meilleure illustration des 
possibilités de stockage et d'affichage quasi-instanta- 
né d'écrans ou de fenêtres d'écran. 

On accède aux fonctions de gestion ‘disque’ par ESC 
et Fon découvre un menu déroulant à barres com- 
prenant toutes les commandes classiques attendues 
d'un interpréteur tel que BASIC.SYSTEM, y compris 
la possiblité d’éjecter en bloc ou sélectivement les 
disquettes 31/2, une fenêtre d'aide, une option quit- 
ter qui n’est ni plus ni moins qu'un sélecteur et lan- 
ceur de fichiers SYS et ce, en ne faisant appel qu'à 
Prodos et à la ROM moniteur. 

Note technique : le lanceur est copié dans une zone réser- 
vée de GE.DSK qui le transfère à un emplacement paisible 
de la RAM ($1CO0) pour dégager l'espace débutant en 
$2000 et permettre le chargement des fichiers SYS. 

Il n'est nullement nécessaire que BASIC.SYSTEM soit 
actif. Une sous-option de ‘quitter’ permet un retour 
au basic, s'il est disponible, sinon on peut lancer BA- 
SIC.SYSTEM à condition qu'il soit dans le même ca- 
talogue ou sous-catalogue. 

Le gestionnaire de disque permet également de 
changer de volume en affichant tous ceux qui sont en 
ligne, indique ceux qui ne le sont pas et affiche le 
tout dans une fenêtre (maximum 12 volumes, confor- 
mément aux possibilités de Prodos 8). 

GE.DSK se présente sous forme de menus dérou- 
lants multi-fenêtres aux options et commandes tota- 
lement transparentes à l'utilisateur, avec une gestion 
rigoureuse des erreurs (affichage de messages en 
clair au lieu de mystérieux codes d'erreur MLT), ce 
qui lui donne une facture trés professionnelle el un 
‘look’ conforme à ce que l'on peut exiger aujourd'hui 
en mode texte de nos Apple //. 


Cette seule partie représente probablement une des 
principales qualités de GE 80 par un conséquent tra- 
vail de programmation en assembleur et le souci de 
permettre à travers le source DSK.:S, la récupération 
d'une importante librairie de routines optimisées et 
structurées. Sans aucune prétention, je recommande 
l'étude des sources, établis et documentés dans un 
souci de transparence. A titre d'information, GE 80 
représente environ 854) instructions et 150 pages de 
listing. 

GE.DSK est réutilisable en bloc moyennant quelques 
modestes aménagements ct adaptations pour l'af- 
franchir de ses liens et d'appels à certaines routines 
de GE.EDIT qu'il conviendrait dans ce cas de rapa- 
trier. Il pourrait servir de ‘disk manager’ pour tout 
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programme nécessitant une gestion d’entrées/sor- 
ties. 


GE.DSK propose les options suivantes: 

+ catalogue, sous-catalogues et information fichiers 

+ changer de volume 

+ gestion de la date (si pas de carte horloge pour 2e) 
+ affichage d'un écran 

+ sauvegarde d’un écran sur disque 

* protéger, cacher un fichier 

+ renommer un fichier 

+ supprimer un fichier 

+ créer un sous-catalogue 

+ éjecter un ou plusieurs disques 

+ aide à la gestion disque 

° quitter 

À noter que les écrans ou fenêtres peuvent être sau- 
vés soit en RAM par la commande S-W, soit sur dis- 


que, à partir du menu ‘optons'ou, au Cours d'un tra- | 
vail, par S-S dans le style d’Appleworks, en propo- : 


sant le nom du dernier écran chargé. 

Note technique: les écrans où fenêtres sont sauvegardés 
avec leurs coordonnées et sous forme de fichiers de fype 
$F5 (SCRI. Si, en sélectionnant l'option “sauver” dans le 
menn général, on appuye sur G-d, l'écran ou la fenêtre 
sera sauvegardé sans ses coordonnées et sa longueur cor- 
respondra strictement au nombre de caractères affichables 
à l'écran; le fichier, dans ce cas, sera de type TXT pour 
une récupération éventuelle dans un traitement de texte 
ou un éditeur quelconque. 


Deux autres segments, dont l’un est indispensable, 
accompagnent GE.SYSTEM: 


GE.TOOLS (l'indispensable 
utilitaire d'application) 


GE.TOOLS est un pelit fichier de 463 octets permet- 
tant, à partir d’un programme Applesoft, Pascal ou 
Assembleur, de charger les écrans ou fenêtres géné- 
rés par GE 80, ceux-ci s’affichant instantanément et, 
en prime, lorsqu'il s'agit d’une fenêtre, GE-TOOLS 
permet de générer un menu déroulant s'inscrivant 
dans celle-ci. Pour une fenêtre de N lignes, la barre 
haute du menu est placée à la ligne 4 et la barre 
basse du menu est à la position N-3. 


GE.TOOLS permet de sauver le fond de fenêtre et de 


le restituer à la fermeture de celle-ci. 


! 
1 


Pour illustrer les possiblités de GE.TOOLS, il est | 


fourni un petit programme Applesoft intitulé 
GE.DEMO qui utilise toutes les fonctions internes de 
GE.TOOLS (afficher un écran ou une fenêtre, sauver 
un fond de fenêtre ou un écran, générer un menu dé- 
roulant à partir d'une fenêtre donnée, récupérer le 
numéro de l'option sélectionnée par RETURN à 
l'adresse décimale 30 (par un PEEK (30) en basic ap- 
plesoft). 

La routine GE.TOOLS étant relogeable, celle-ci peut 
être placée n'importe où, par exemple entre Prodos 
et ses fichiers en allouant le nombre de pages mé- 
moire nécessaires au stockage de la routine et des 
écrans ou fenêtres (voir annexe). 


Il serait trés facile de transformer GE.TOOLS en 
commande externe en utilisant Ja routine 
CMDLOAD bien connue des ‘Applemaniaques’. 
Autre formule: à la suite d'un programme basic. 


RS SNS 
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GE.CONFIG (un LS 
pour personnaliser GE.SYSTEM) 


I s'agit d’un petit fichier SYS écrit également en as- 
sembleur et en harmonie avec le look de GE 80, qui 
permet de ‘patcher’ GE,SYSTEM pour fixer une pré- 
sentation par défaut, au lancement, à savoir: 

* cadre ou pas cadre, 

* plein écran ou écran avec barre de commande, 

+ mise en place ou non d'une règle de tabulation, 

* clavier sonore ou silencieux, 

+ insertion ou écrasement, 

+ choix de la couleur d'impression. 

Ce fichier peut être lancé soit à partir de GE.SYTEM 
par le sélecteur interne, soit indépendamment. I] 
n'est opérant que si GE.SYSTEM est présent dans le 
même catalogue ou sous-catalogue, sinon il y a affi- 
chage d’un message d'erreur. Une fois la configura- 
tion effectuée, une option permet d'accéder directe- 
ment à GE-SYSTEM. 

Enfin divers fichiers ‘écran’ ou ‘fenêtre’, du type $F5 
ou SCR comme (SCRjcen, sont fournis à titre 
d'exemples. On notera la présence d'un fichier 
‘écran’ nommé GE.BITMAP particulièrement inté- 
ressant pour les lecteurs qui souhaiteraient tirer parti 
des routines de GE 80. Cet écran se présente sous 
forme d'un tableau donnant toute la structure et 
l'emplacement des principaux segments de GE 80. 


En conclusion, GE 80, c'est: 

° GESYSTEM, fichier SYS qui comporte entre 
autres, deux scements implantés selon les adresses 
fournies dans GE.BITMAP: 

» l'éditeur GE.EDIT et, 

+ le gestionnaire de disque GE.DSK 

+ GE.CONFIG, fichier SYS 

+ GE.TOOLS, fichier BIN 

* GEDEMO, fichier BAS. 

GE.DEMO cest associé aux fichiers DEMO.MASK, 

DEMO.MENU et DEMO.MSG 


Tous les sources sont fournis et sont assemblés avec 
MERLIN. GE 80 est essentiellement bâti autour 
d'une routine simple et paramétrable (MEMO, située 
dans GE.DSK), de lecture/écriture d'écrans ou fc- 
nêtres-texte en 80 colonnes entre la RAM et la mé- 
moire écran, 


Cette routine est d'ailleurs utilisée constamment 
dans le développement de ce logiciel pour gérer 
toutes sortes de fenêtres à ouvrir ou fermer sans 
perdre d’information. 


À propos de GE 80: appuyez sur Option-? quand 
vous êtes dans l'éditeur! 


Exemple d'utilisation de GE.TOOLS dans 
un programme BASIC APPLESOFT 


. 1. On réserve une zone mémoire en abaissant HI- 
MEM et en allouant le nombre de pages-mémoire né- 
cessaires pour stocker: 

+ l'écran initial (masque ou fond d'écran), 
* la fenêtre de menu, 
* le fond de fenêtre, 
2. On charge GE.TOOLS à l'adresse HIMEM, 
3. On charge le masque et la fenêtre de menu, 
4. On assigne à des variables les adresses respectives 


de HIMEM et des zones de stockage de DE- 

MO.MASK, DEMO.MENU et le fond de fenêtre (N, 

À, B,C), 

5. Un écran ou une fenêtre s'affiche par: 

CALL N,A où N = HIMEM, A = adresse écran 

6. Un menu déroulant s'affiche de la mème façon 

mais avec 3 paramètres: 

CALL N,B,C où N = HIMEM, B = adresse menu, C = 

adresse fond de fenêtre. 

On dispose de la commande ESC pour quitter le me- 

nu et revenir à l'écran initial avec restauration du 

fond de fenêtre. On sélectionne une option du menu 
ar JL. Le numéro de l'option choisie est récupérable 

par PEEK (30). 


On trouvera ci-après, le listing d’un petit programme 
intitulé GE.DEMO) illustrant la méthode précédente: 


Listing de ‘GE.DEMO" 


10 rem ——-—— préparation -—--"- > 

30 d$ = chr$(4) 

40 print d$"pr£3":print 

50 print d$"-ALLOCATE "rem -- allone 17 pages- 
MÉMOIrE — 

60 print d$"bload GE.TOOLS,TREL,A$8800" 

70 print df"bload DEMO.MASK,T$F5,A$8A00" 

80 print d$"bload DEMO.MENU,T$F5,A$9184" 

90 print df"bload DEMO.MSG,TSF5,A$9488" 

UK} himem:34816 


120 rem PTOQNQININE --"""""""- 
140 N = 34816:A - 35328:B = 37252:C = 38024 
150 call N,A:rem -------— affichage du menu —-— 


160 poke 49168 (wait -16384,128:K — peek (49152) 
170 if K <> 155 then 160 

180 call N,A:rem----. affichage du décor 
190 wait -16384,128:K=peck (49152) 

200 if K = 155 then 160 

210 if K = 141 then poke 49168,0 

220 NB = pcek (30) 

230 call N,/C:rem ---—— affichage du message final ———- 
240 poke 1403,54:vtab 14:print NB 

250 poke 49168 0:wait -16384,128 

260 home:if NB <> 3 then 150:rem -- option 3 = sortie 
270 poke 49168 0:end 


NB: ALLOCATE est une routine trés courte, implan- 
téc en $300, qui alloue le nombre de pages-mémoire 
nécessaires à ce programme (il est rappelé qu'une 
page-mémoire a une longueur de 256 octets}. La rou- 
tinc en assembleur correspondante est la suivante: 


ORG $300 ; adresse d'assemblage 

JSR $BEF8 : ré-initialise les buffers 
LDA NB_PAGES : nombre de pages à allouer 
JMP $BEF5 :allocation de NB_PAGES 


I est commode et plus simple d'introduire cette rou- 
tine dans le programme basic précédent par des DA- 
TA (8 valeurs à lire) de la façon suivante: 


50 for [= 0 to 7:read J:poke 768+L)]: next I 
55 call 768 


“usure 


300 data 32,248,190,169,17,44,245,190 


Le nombre 17 (souligné) représente le nombre de 
pages à allouer. 
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GE 80 : Principales commandes de l'éditeur d'écrans et fenêtres | 


Touche Fonction Touche Fonction 


Avance d'un caractère 3 Recule d’un caractère 
Monte d'une ligne Descend d'une ligne 

Curseur en début de ligne G — Curseur en fin de ligne 
Curseur en haut de l'écran 4 Curseur en bas de l'écran 
Curseur en début d'écran Option-L Curseur en fin d'écran 
Avance d'un mot Option  Recule d’un mot 

Avance d'une tabulation G-TAB Recule d’une tabulation 

Efface 1 car. à gauche G-DEL Efface 1 car. sous le curseur 
Efface à gauche du curseur G-D Efface à droite du curseur 
Efface l'écran/video normale  Option-ESC Efface l'écran/ vidéo inverse 
Insère une ligne G-O Supprime une ligne 

Copie une ligne 3-C Copie 1 chaîne de caractères 
Sauve l'écran en MEV S-R Affiche 1 écran stocké en MEV 
Sauvegarde l'écran sur disque Option-W  Duplique 1 écran en MEV 
Mise en mode fenêtre Option-M Edition d'une fenêtre 

À propos de GE.80 5-Q Quitter GE.80 


Fonction ou effet Observations 


Mode NOR /INV MOUSE 
Insertion /recouvrement 

Ecrit vertical /horizontal 

Avec ou sans son 

Avec ou sans ligne de commandes 
Avec ou sans cadre 

Avec ou sans réglette 


Commandes 


de type 


bascule’ 


VW OM) NOM NW N 


Conversion Inv. <-> nor. Mode normal 
Conversion Maj. <-> min. tapez: -| 


Mode fenêtre / mode > Déplacer le curseur 
Option] ESC  Edite une fenêtre / retour mode normal > vers l'extrémité 
CD Déplace une fenêtre (droite / gauche) > de la diagonale 
GT ci -d°- (haut / bas) > et. 
Option-F Option-C Pleine fenêtre / avec ou sans cadre > 








« C'est pas grave : moi, je les ai déjà. 





Mais vous, il faudra que vous attendiez les prochains TooïlBox Mag. Ils sont déjà dans nos 
tiroirs: restez branchés, et vous aurez (entre autres): 


+ Un NDA “Lynx” de Patrick Desnoues (?). { | 

+ Une étude de Jacques Liautard "Il ne fui manque même pas la parole”, ou comment faire | 
parler le GS. 

+ L'anatomie des disquèttes GS/OS 5.04, suite du “GS pour débutants” d'Eric Weyland. 

+ Une revue logicielle de l' indispensable Genesys 1.2, par un expert: l'ami François Uhrich. 

+ Un (dé)-compilateur de ressources complet de Jacques Destelle: adieu à la galère Rez! ; 

+ Une étude de votre serviteur sur la Personal LaserWriter :“La Laser sans le Mac. 

+ Un excellent lanceur de Jacques Destelle, qui rendra Wings largement superflu. 

+ Une étude de notre ressourcier Bernard Fournier sur la cohabitation, et même la AU 
entre le Pascal et l'Assembleur. 

.+ Une série d'études du os Jacques Destelle sur le passage simultané du 8 au x 16 bits et de 
l'Applésoft au Pascal. 

+ And much, much more. EE 





 J.Y. Bourdin 





Ne vous étonnez pas si j'ai du mal à croire que l'Apple II GS est mort… 
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Les mégas à la pelle, c'est bien beau, el c'est indis- 
pensable aujourd'hui pour qui veut réellement utili- 
ser son CS. Mais cela pose des problèmes nouveaux, 
toujours nos “problèmes de riches": il faut ranger et 
gérer tout ça. Cet article voudrait montrer aux utili- 
sateurs de disque dur comment se sortir d'une des 
galères les plus fréquentes (à l'optimisation), ef aux 
utilisateurs de lecteurs de cartouches Syquest com- 
ment en finir avec la galère. 


“Ca plante quand j'optimise” 


Vous avez commencé à optimiser votre disque 
dur, c'est-à-dire en fait à le ranger. Et voilà 
qu'au beau milieu, tout plante. Du coup, en 
guise de rangement, vous avez un bazar ter- 
rible. Et vous commencez à injurier Prosel ou 
Vitesse: parce qu'en plus, ce n'est pas la pre- 
mière fois! Alors, pourquoi, et que faire? 


Trois raisons possibles au plantage, dont deux 
inévitables: 


1/ Un plantage soft du logiciel ou du système. 
Personne n'est parfait, ce genre d'accident n'est 
pas évitable par principe: l'optimisation d'un 
disque dur demande énormément de travail 
très complexe au système. Ce système peut par 
ailleurs être assez fragile: le driver de disque 
dur SCSI d'Apple est encore loin d'être parfait, 
même chose pour la carte SCSI-DMA Apple. La 
vitesse a un prix. 


2/ L'apparition de “bad blocks” en plein mi- 


lieu du travail. Là non plus, ce genre de chose 


n'est pas évitable, par principe. Voir ci-dessous. 


3/ Quelque chose que vous pouvez éviter: le 
manque de mémoire dans votre GS, ou le 
manque d'espace libre sur le dur. Quand vous 
faîtes ce travail, chassez les accessoires, détrui- 
sez quelques jeux ou archives inutiles sur le dur. 
: Un disque dur ne devrait jamais être rempli à 
_ plus de 80% de la capacité de chaque partition. 


PTT PAR : 
: L'expérience m'enseigne que la raison la plus 


fréquente est en fait la seconde: l'apparition de 
bad blacks. Même quand vous avez fixé les bad 
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blocks auparavant avec Prosel ou Delivrance, ii 
s'en crée au beau milieu de l'optimisation! C'est 
vicieux, c'est diabolique, mais. c'est normal! 


L'opération délicate, sur un disque, n'est en effet 
pas tant la lecture que l'écriture. C'est au cours 
des opérations d'écriture que les bad blocks se 
fabriquent. Or, il v a des zones de votre disque 
dur sur lesquelles vous n'écrivez jamais: celle où 
il y a les 780k du fichier Appleworks-Gs, par 
exemple, est souvent lue, mais jamais écrite. 
Sauf dans un cas: quand vous optimisez le dur, 
précisément. 


Le programme optimiseur aura donc lu un bloc, 
puis l'aura écrit, puis deviendra incapable de re- 
lire le même bloc: nul ne peut se tirer de ce 
genre de situation. Joint aux pépins soft eux 
aussi inévitables, une conclusion s'impose: l'op- 
timisation du dur est par nature une opération 
dangereuse! Les documentations le disent, mais 
il faut l'expérience pour le comprendre: “C'est 
dangereux” signifie “Ça va planter” ! 


La première règle est donc la prudence: avant 
toute optimisation, faire un back-up, bien sûr. 
Mais pas seulement: vérifier l'intégrité des cata- 
logues, emprisonner les bad blocks (rappelons 
que les bad blocks sont chose parfaitement nor- 
male sur un disque dur). 


De ce point de vue, le programme “Delive- 
rance”, de Vitesse, a une option très intéres- 
sante: le réglage de la sensibilité dans la lec- 
ture des bad blocks. Si on fait confiance au sys- 
tème, celui-ci va relire plusieurs fois (jusqu'à 30 
fois pour GS/OS) un bloc qu'il n'arrive pas à 
lire, [1 va donc accepter des blocs douteux. J'ai 6 
bad blocks sur la partition de 43000 blocs sur la- 
quelle je travaille en ce moment: je me moque 
parfaitement d'en avoir 100 ou 200, si cela m'as- 
sure que tous les blocs douteux sont mis à part, 
donc que je ne tomberai pas inopinément sur un 
bad block. 

Cela dit, il y aura toujours apparition de nou- 
veaux bad blocks à l'optimisation: si le pro- 
gramme de vérification des bad blocks devait 
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faire autre chose que lire, par exemple lire et 
écrire 30 fois chaque bloc, il faudrait 24 heures 
pour vérifier un dur, et cela n'empêcherait pas 
l'apparition de quelques nouveaux bad blocks à 
la 31e fois. Et il y aura toujours le risque de 
plantages soft. 


La conclusion de tout ça, c'est que la qualité 
principale d'un programme d'optimisation du 
dur n'est pas sa rapidité, ni sa beauté, ni toute 
autre considération subalterne. Ce n'est pas non 
plus qu'il ne plante pas: le programme ou le sys- 
tème planteront forcément une fois ou l'autre. 


En fait, la qualité principale d'un programme 
d'optimisation du dur, c'est sa capacité à lais- 
ser les choses les plus propres possibles en cas 
de pépin. De ce point de vue, je dois dire du 
mal de Renaissance, de Vitesse: il m'a laissé 
deux fois un disque dur bon à reformater, avec 
rien, absolument rien, de récupérable! 


Dans l'état actuel de mes connaissances, je ne 
peux dire du bien que de deux programmes op- 
timiseurs: Beach Comber version 3.7 de Pro- 
sel 8 (eh oui, il optimise parfaitement les fichiers 
étendus de GS/O5, même sous P8), assez lent 
mais très fiable, et Prosel 16, dans ses versions 
récentes (8.55 et au-delà). Passant par GS/OS et 
son driver SCSEL, il est plus rapide que Beach 
Comber 8, mais moins fiable. Seulement, quand 
l'optimiseur de Prosel 16 plante, il laisse au 
maximum deux ou trois fichiers abîmés. Repas- 
sez au vérificateur de volumes, détruisez ces 
deux ou trois fichiers, vérifiez le catalogue, re- 
passez au chasseur de bad blocks, recopiez les 
fichiers détruits à partir du backup, et. vous 
pouvez relancer une nouvelle optimisation! 


Il m'est arrivé fréquemment de m'y reprendre 
à deux ou trois fois pour optimiser un dur avec 
Prosel. Il laisse les choses suffisamment propres 
pour qu'on puisse reprendre le travail ensuite. 
Autre supériorité de Prosel: sa fonction d'opti- 
misation dite “Turbo”, qui se contente de dé- 
fragmenter les nouveaux fichiers qui ont été 
fragmentés depuis la dernière optimisation, 
sans reprendre le rangement d'ensemble du 
dur. 


Bref, optimiser, c'est dangereux. Soyez pru- 
dents, et comme d'habitude: “Prosel, ou tu 
meurs”. 


Un dernier conseil: avec un système et des pro- 
grammes qui utilisent en permanence le relais 
sur disque, il est préférable de ne pas demander 
à ces systèmes et programmes de s'optimiser 
eux-mêmes en plein travail! Quand vous pei- 
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Patch Chinook 


Voici un patch pour les utilisateurs des 
Chinook Utilities version 1.5, pour avoir 
des “|” à la place des “Ü”: 


D 
8 BLOAD CSU,1.5.SYSTEM, AS2000.TSFF 
$ CALL - 151 
“ 6826: AI 
* BSAVE CSU.1,5,SYSTEM, A$2000, T$FF 


| 

JYB 
RS 
gnez votre dur, il est bien préférable de le faire à 
partir d'un mini-système avec Prosel que vous 
aurez booté à partir d'une disquette. Si ça 
plante, vous pourrez toujours repartir de la dis- 
quelle. 





i 
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Syquest: la galère 
des back-ups, c'est finil 


N'hésitons pas à l'écrire, il y à quelque chose de 
mieux qu'un Syquest, en matière de mémoire 
de masse pour le GS: deux Syquest, bien sûr! 
Depuis que j'ai le second, je me demande com- 
ment j'ai pu vivre avec un seul lecteur: puisque 
c'est un lecteur de disquettes, il en faut deux, 
pour les copies. Ne faîtes plus de back-ups sur 
disquettes 3,5, copiez tout simplement. N'opti- 
misez plus la cartouche après l'avoir restaurée 
depuis le back-up: votre copie est déjà optimi- 
sée. Le second Syquest, c'est La fin de la galère 
des back-ups. 


Attendez, ne partez pas! Ce que vous ne savez 
pas, c'est que le second Syquest est gratuit: 
vous l'avez déjà si vous avez le premier. 


Comment se fait-il qu'il m'ait fallu presque un 
an pour m'en rendre compte, alors que c'est to- 
talement évident? Et comment se fait-il que per- 
sonne à ma connaissance ne s'en soit rendu 
compte avant? Eh bien, j'avais gardé mes habi- 
tudes du disque dur avec back-up sur dis- 
quettes, voilà. Le poids de l'habitude, nous en 
moOuITOns {ous 


Voici donc ce truc évident: votre cartouche Sy- 
quest fait 42 Mégas, et vous en avez bien enten- 
du une autre pour les back-ups. Tant que nous 
gardons la limite de 32 Mégas du FST Prodos de 
G5/0$, cela signifie qu'il faut faire deux parti- 
tions par cartouche, soit 4 partitions en tout. Le 
truc, c'est tout simplement de partitionner cha- 
que cartouche de 42 Mégas en deux partitions 














| 
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strictement égales en nombre de blocs (43 008 
blocs, 21 504k), et de consacrer la deuxième 
partition de chaque cartouche au back-up de la 
première. 


Le back-up d'une partition de 21 Mégas se fait 
en sept minutes trente montre en main sur ma 
configuration. Et pendant ces sept minutes, je 
vais boire tranquille un café, sans toucher à une 
seule disquette ni m'occuper de rien. Il suffit de 
copier la première partition sur la seconde, et le 
back-up est fait! 


Bien entendu, pas une copie fichier par fichier, 
et surtout pas avec le Finder: non seulement ce 
serait beaucoup trop long, mais il faudrait en- 
suite optimiser la seconde partition, comme la 
première. 


H faut faire une copie physique, par blocs: c'est 
pour cela que vous avez créé deux partitions de 
21 Mégas par cartouche, strictement identiques 
en nombre de blocs. Comme toujours, n'essayez 
pas de faire ça avec le Finder: ça devrait mar- 
cher (en faisant glisser l'icône de la première 
partition sur la seconde), maïs ça ne marche pas, 
bien entendu (erreur SFE04, pourquoi pas celle- 
là). En revanche, évidemment, ça marche 
comme sur des roulettes avec la commande 
“Copy Volume” de Prosel 16! Prosel, ou tu 
meurs. 


Dès que la copie est terminée, renommez la se- 
conde partition pour qu'elle ne garde pas le 
même nom que le première, et c'est fini. Au lieu 
d'avoir une cartouche “originale” de 42 Mégas 
et son back-up sur une autre cartouche de 42 
Mégas, vous avez deux cartouches “originales” 
de 21 Mégas contenant chacune son propre 
back-up! 


Léger inconvénient de cette formule: toutes vas 
partitions comprendront une copie du système, 
alors qu'avec la formule habituelle, la seconde 
partition n'en avait pas besoin. Vous perdez 
donc un peu de place. Je ne compte pas comme 
un véritable inconvénient la nécessité de chan- 
ger de cartouche pour passer à la partition avec 
Xénocide: expérience faite, ce n'est pas gènant 
de n'avoir que 21 Mégas en ligne en même 
temps, quant il suffit de changer de cartouche. 


Et la sécurité ? 


Du point de vue de la sécurité, malgré les appa- 
rences, cette formule est très sûre: si votre Sy- 
quest tombe en panne, vos data sont toujours là 
sur la cartouche, et vous pouvez les récupérer 
sur le Syquest du copain. Si c'est la cartouche 
qui tombe en panne, cela ne se fait que d'une 
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seule façon à ma connaissance: par l'apparition 
de bad blocks. Or, il est statistiquement impos- 
sible que ces bad blocks apparaissent sur les 
mêmes blocs des mêmes fichiers sur les deux 
partitions en même temps: il y aura toujours, 
pour chaque fichier, une des deux partitions de 
bonne. 










Même si les deux blocs 2 sont abîmés 
ensemble (!), effacez les partitions sans les refor- 
mater (commande Erase de Prosel 16 et 
GS/05), et vous récupérerez tout ce qui est en 
sous-catalogue (toujours avec Prosel 16). Si 
GS/OS$ ne reconnaît même pas deux partitions à 
effacer, rien n'est encore perdu: repartitionnez 
allègrement la cartouche (sans reformater physi- 
quement, bien entendu), en reconslituant deux 
partitions strictement égales, puis faîtes comme 
ci-dessus (effacer et récupérer le contenu des 
sous-catalogues). Pour partitionner sans forma- 
ter, les utilitaires disques du système Apple ne 
conviennent pas plus que le Finder ne convient 
pour copier les disques: j'utilise les Utilitaires 
Chinook version 1.5 (attention, ces utilitaires ne 
marchent qu'avec une carte SCSI Apple). 




























Je ne vois de vrai danger à cette solution que 
dans un seul cas: la carte SCSI se réserve au dé- 
but de votre cartouche 32 blocs pour une parti- 
tion “invisible” appelée “Apple Parti- 
tion Map”. Si le premier de ces blocs invisibles, 
qui est aussi le premier bloc physique SCSI de la 
cartouche, est devenu un bad block, essayez de 
repartitionner comme indiqué ci-dessus: géné- 
ralement, on peut réécrire ce bloc. Si ce n'est pas 
possible, il y a encore une solution: demandez 
aux utilitaires Chinook de réassigner les bad 
blacks (c'est une commande SCSF), puis reparti- 
tionnez. Neuf fois sur dix, ça marche. Mais la 
dixième fois, votre cartouche est irrécupérable 
(pas absolument d'ailleurs, mais nous entrons 
alors dans le domaine de la bidouille SCSI im- 
publiable}, et vos data sont perdues. 










Ii y a danc une chance sur 86 000 pour que vous 
ayez un bad black en bloc physique zéro, et 
dans ce cas, une chance sur dix pour le désastre. 
Une chance sur 860 000 d'aller au désastre, tel 
est le prix du “second Syquest gratuit”. Je ne 
connais pas encore d'exemple où ce désastre du 
bloc Q illisible soit arrivé, mais 1/860 000, ça 
n'est pas zéro. Si vous refusez ce prix, ou si 
vous voulez aussi vous protéger contre les ris- 
ques de destruction physique de la cartouche 
(tasse de café, B52, etc) vous pouvez continuer 
avec les back-ups sur disquette 3,5, ou... vous 
offrir un second Syquest. 
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Récupérer un source Complete 
(TML) Pascal sous Orca Pascal 


Michel Racine 


L'éditeur "Prizm” (voir article de François Uhrich 
sur Orca C dans le n°1) est très performant mais as- 
sez susceptible: vous ne pourrez charger le fichier 
source (de type texte} que si la dernière ligne est 
vide (retour chariot seul). Un passage à travers 
l'éditeur d'Orca en mode texte (Entrez successive- 
ment "Edit MonTexte", "Control Q", "S"}, résoud le 
problème. 

Lors du chargement dans Prizm ou dans l'éditeur 
en mode texte, le 7ème bit de tous les caractères de 
code > $7F (nos chers accents) est mis à zéro. 

Pour gérer ces caractères, définir des variables: var 
eAigu: char; les initialiser: eAiçu := chri$8E}; puis 
remplacer des mots comme ‘insérez...’ par ‘ins’, 
eAigu, rez..." 

Les versions actuelles des éditeurs ne gèrent pas 
les caractères de tabulation (Control 1) qui appa- 
raissent en vidéo inverse, ainsi que tous les carac- 
tères accentués dont le 7ème bit a été mis à zéro. Il 
est possible de remplacer tous ces caractères par 
des espaces en faisant passer l'ensemble du texte 
par le presse-papier, ou en utilisant l'utilitaire DE- 
TAB pour les tabulations. 

Pour un source très simple comme celui de l'unité 
ST le travail est presque terminé: il suffit d'ajouter 
des parenthèses aux paramètres qui suivent le mot 
clé "Tool" et de modifier quelques identificateurs: 
Maxlnt remplacé par 32767 et string par pString. 
Mais souvent il reste encore beaucoup à faire. Il 
faut comparer les directives de compilation, les 
identificateurs d'unités, les identificateurs des 
types définis dans ces unités, ainsi que ceux des 
procédures et fonctions (et je ne suis pas exhaustif}, 
L'option "Check for Errors" du menu “Run de 
Prizm aide à repérer les modifications nécessaires. 
La commande "Canon" d'APW, utilisée avec le dic- 
tionnaire adéquat, devrait pouvoir automatiser les 
remplacements. Possédant seulement la documen- 
tation d'Orca Pascal il m'est difficile d'établir ce 
dictionnaire. En particulier, il faut comparer les 
identificateurs de toutes les fonctions et procédures 
effectuant les appels à la Toolbox ainsi que ceux 
des structures de données liées à la Toolbox (et 
donc posséder le source des interfaces Toolbox 
pour les deux compilateurs). 

Pour les programmes utilisant les ressources, 
conservez soigneusement la portion ressources du 
programme compilé ou les fichiers de type S00 
dont le nom se termine par ".r". Modifier les res- 
sources sous Orca suppose d'avoir installé DeRez 
et Rez. 

Pour terminer, déroulez le menu "Languages" de 
Prizm et choisissez "Pascal" avant de sauvegarder 
(ou utilisez la commande "CHANGE MonTexte Pas- 
cal" d'Orca). 


ToolBox Mag n° 4 


Too! 219 : version 1.1.1 


Dans le sous-catalogue /TOOL219.V.1.1.1, vous 

trouverez la dernière version de notre Sound- 

Smith Tool. Juste des corrections de bugs, dont 

un sérieux. 

Faute de place sur la disquette, nous n'avons 

mis qu'un fichier-source de compléments et de 

corrections au source Merlin publié dans Tool- 

Box Mag 3. A vous de faire le copier-coller né-| 
cessaire. f 
Dans /TOOL219.V.1.1.1/0RCA.PASCAL, vous || 
trouverez les interfaces du Tool219 pour Orca 

Pascal par Michel Racine. Attention, le fichier 

STLib doit venir impérativement avant PasLib 

dans votre catalogue /LIBRARIES. 

Michel Racine en a profité pour nous envoyer 

quelques notes sur la traduction d'un source 

TML en source Orca Pascal (voir ci-contre): ce 

n'est pas si facile. 

Le Too1219 va bientôt être le Tool le plus docu- 

menté et le mieux débugué du GS. En tout cas, | 


c'est vraiment une œuvre collective. ; 


Premiers conseils sur HyperCard 


Donc, les piles HyperCard, c'est parti mon ki- 
ki, en musique et en couleurs. Bien entendu, 
les prochains TooÏlBox Mag vont vous présen- 
ter HyperCard, et vous permettre de tirer le 
maximum de ce qui est bien l'Applesoft des 
années 90. 
Mais en attendant, quelques conseils tout de 
suite pour ne pas être perdu dans HC: 
+ D'abord, rappelez-vous que c'est Hyper- 
Card: on ne sauve pas, tout est sauvé sur dis- 
que en temps réel. Une fausse manœuvre 
dans votre pile “Home” esl enregistrée immé- 
diatement! Les back-ups sont une nécessité 
absolue avec HC. 
+ Beaucoup de piles cherchent à vous faire na- 
viguer “bêtement”, “en aveugle”, dans Hyper- 
Card, comme sur un vulgaire Mac. Pour rester 
sur GS, et naviguer sans crainte dans HC, il y 
a trois commandes à garder en mémoire, et 
trois seulement: 
* -Espace: donne accès à la barre de menus 
| d'HyperCard qu'on voulait vous cacher. 
+ Pour avoir accès à tous les scripts qu'on 
vous dissimule, par exemple ceux des bou- 
tons: S-Option-Shift, puis un double-clic sur 
la Zone dont on veut étudier le script. 
‘+0 en déroulant le Menu File vous donne. 
l'accès à l'item du menu qui permet de|| 
déprotéger les piles soit-disant “protégées”. 
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Dans nos deux premiers articles, nous avons étudié 
comment étaient constituées les ressources. Nous 
n'avions alors abordé le problème que sous l'aspect 
de la création/modification de ressources avec des 
éditeurs de ressources. 
A l'occasion des exemples, nous avions vu la sou- 
plesse apportée par les ressources qui permettent de 
stocker tous les fichiers de données d'une applica- 
tion. Partant de là, on peut fort bien imaginer de 
conserver sous forme de ressources les meilleurs 
scores d'un jeu, ou bien la configuration par défaut 
: de tel ou tel logiciel. 
| A priori, rien ne s'y oppose, bien au contraire direz- 
vous... Eh bien non ! En informatique comme dans 
bien d'autres domaines, il ne faut pas vendre ia peau 
de l'ours trop tôt! Et dans le cas présent: la modifica- 
tion de ressources par voie logicielle est. disons pas 
évidente du tout. Apple y à d'ailleurs consacré une 
Note Technique (83). 
À 
| 


NB: nous suivrons ici grosso modo les conseils d'Apple, 
tout en sachant que cela laisse subsister un problème 
(double chargement des ressources marquées PreLond), 
Eventuellement, nous pourrons étudier dans nn prochain 
numéro comment contourner ce problème. 


Le problèrne 


Pour constater le problème, lançons l'application UP- 
DATEFALSE qui se trouve sur la disquette ToolBox 
Mag 4. Que sc passe-t-il ? Deux ressources rPstring 
sont affichées successivement et on tente de les mo- 
difier par UyDateResource puis par WriteResource: 
dans les deux cas l'erreur $4E est retournée et nos 
ressources ne sont pas modifiées sur disque. 

Que signifie ce code d'erreur? C'est un message 
GS/O$ signifiant que le code d'accès au fichier inter- 
dit l'opération en cours. Intéressant. Cela veut donc 
dire que le fichier ressource de l'application en cours 
est protégé contre l'écriture. Le remède est évident: il 
suffit de trouver le moyen de déprotéger le fichier 
ressource de l'application courante pour que tous 
nos malheurs soient résolus. 


Les causes 


Réfléchissons un peu. Si on ouvre un fichier res- 
source quelconque et que l'on modifie une de ses res- 
sources, celle-ci est sauvée sans problème sur disque 
(c'est ainsi que l'on peut modifer des ressources avec 
Genesys par exemple). Cependant un problème sur- 
vient lorsqu'on veut qu'une application modifie elle- 
même ses ressources. Quelle peut bien être la cause de 
ce phénomène ? 

Tout simplement lorsqu'on édite un fichier ressource 
quelconque, on procède comme suit: 
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Les Ressources du GS, troisième Partie : 





Modifier ses ressources “à la volée” 


Bernard Fournier 


+ OpenResourceFtle 

+ LondResource 

+ MarkResourceCharige 

e LipDateResource ou WriteResource 

e CloseResorceFile 

Et lorsqu'on travaille sur le fichier ressource de l'ap- 
plication en cours, on fait: 

+ LoadResource 

+ MarkResourceChange 

+ UpDateResource ou WriteResource 

Pas besoin de chercher plus loin: dans un cas on pro- 
cède manuellement à l'ouverture/fermeture du fi- 
chier ressource, et dans l'autres on laisse ce soin au 
Resource Manager par l'intermédiaire de Start Up- 
Tools. C'est ici la cause de nos tracas: le Resource Ma 
nager ouvre le fichier ressource de l'application en cours 
en H'autorisan! que la lecture, d'où le code $4E lors- 
qu'on tente une modification. 


Le remède 


La cause étant trouvée, reste à trouver un moyen de 
‘feinter’ le Resource Manager. De manière intuitive, 
on sait qu'il va falloir ouvrir et fermer nous-mêmes 
les ressources, ceci afin d'avoir l'autorisation d'écri- 
ture sur disque. 

Cependant, il ne faut pas oublier que le Resource 
Manager ouvre systématiquement les ressources de 
l'application lors du startup ! 

Donc marche à suivre: 


+ fermer Le fichier ressource de l'application courante 

* ouvrir manuellement le fichier ressource de l'appli- 
cation courante 

° faire les modifications de notre choix 

° fermer manuellement le fichier ressource de l'ap- 
plication courante 

Regardons les paramètres à passer à ces instructions: 

» CloseResourceFile: admet un Fileld comme argu- 
ment. Cet identifiant sera fourni par GetCurResour- 
ceFile, ce qui permettra de fermer le fichier res- 
source de l'application en cours. 

+ OpenResourceFile: il faut lui passer un pointeur sur 
le nom du fichier ressource à ouvrir. C'est à dire 
concrètement un pointeur sur le nom de l'applica- 
tion en cours. Pour récupérer le nom de l'applica- 
tion en cours, on peut employer GeENameGS. 

+ Enfin la deuxième fermeture manuelle sc fera avec 
le FilelD fourni par OpenResoureeT ile. 


Alors alloms-y: 


phlockPtr.pCouné:=1; 
GetNameGS{pBlockPtr); 

avec pBlockPtr: GetNameRecGs; 
TempPtr:=pBlockPtr.dataBuffer; 
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avec TempPtr:ResultBuf255Ptr; 
GS2PString(TempPtr".bufString,TempStr); 
CloseResourceFile(GetCurResourceFile); 
Fileld:=OpenResourceFile(O nil @TempPtr".bufString); 


On lance... et surprise: ça ne marche pas ! Enfin plus 
concrètement, ça marche des fois oui, des fois non, 
mais plus souvent non. 

En examinant de plus près l'exécution de ce pro- 
gramme, je me suis apperçu que l'erreur provenait 
de GetNameGS: en effet parfois le code $53 est re- 
tourné (paramètres invalides). 

Pas de panique, analysons. GeiNameGS admet un 
pointeur comme paramètre; ce pointeur désigne une 
structure constituée comme suit: 

+ un pcounit (égal à 1) 

° un pointeur sur une chaîne GSOS. 

Et la chaîne GS/O$ est elle-même constituée par: 

* la longueur de chaîne (deux octets) 

° la chaîne proprement dite. 


Avec le programme que nous avons écrit, voici ce 

qui $C passe: 

° l'emploi de pBlockPtr dans GetNameGS fait bien 
empiler un pointeur 

+ ce pointeur référence une structure dont les deux 
premiers octets contiennent la valeur 1 {count} et 
les 4 suivants contiennent... (9 00 00 O0 ! Ce qui 
fait que la chaîne retournée par la fonction {donc le 
nom de l'application) sera placée à l'endroit indi- 
qué par le pointeur (donc en 00/0 soit en plein 
dans la page zéro !). 

Pas étonnant que ça coince ! On est en train d'écrire 

gaillardement sur des zones réservées. 


E faut donc utiliser une autre méthode: déclarer préa- 
lablement des pointeurs pour chacune des structures em- 
ployées et s'assurer que les zones pointées sont vides. 
Pour cela, la fonction NEW est parfaite (à condition 
de déclarer correctement les variables afin de ne pas 
avoir de conflits de types ! Il y a des jours où on en- 
vic les programmeurs en assembleur.…} 


neuwpBlockPtr): avec pBlockPtr: SGetNameRecGs: 
netw{pBufPtr); avec pBufPtr : ResuliBuf255Ptr; 


ceci nous définit deux zones réservées pointées par 
pBlockPtr et par pBufPtr. Il reste maintenant à dire 
que le champ databuffer de pblockPtr pointe sur 
phufP£r: 


pBlockPtr" .pCount:=1; 
pBlockPtr®.dataBuffer:=pointer(pBufPtr); 


et on peut tranquillement faire notre appel 
GetNameGS{pBlockPtr}; 


et récupérer le nom de l'application dans une chaîne 
pascal TempStr: 


GS2PString(pBlockPtr".dataBuffer" bufString, 
TermpStr); 


Notez les quelques lignes suivantes affichant les va- 
leurs des pointeurs: ces routines sont ici uniquement 
à titre pédagogique et montrent comment débugguer 
un programme Pascal sans outil spécial: 


e=Lonsint(&pBlockPir); 
MoveTo{100,40); 
theString:=" 


on déréférence Le pointeur 


on initialise la chaîne 
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Long2Hex(i,pointer(ordé(@theString}+1),6); 
on transfère un octet après le début de la pString !!! 
DrawString(concail"pBlockPtr : $'.theString}); 


Bien, maintenant que l'on a récupéré le nom de l'ap- 
plication en cours, on peut procéder à l'ouverture 
manuelle de ses ressources: 


FilelD:=OvenResourceFile(O,nil,@pBlockP#r 
%,dataBuffer" .bufString); 


Ensuite, on charge une ressource: 
MyHandle:=LoadResource(kResT ype.kResld1 ); 


comme il s'agit de pSiring que l'on veut modifier, on 
va réserver la taille maxi: 


SetHandleSize(256,MyHandle), 


En effet, le MemoryManager et le Resource Manager 
vont charger la chaîne de 10 octets, par exemple, 
dans une zone libre de 10 octets. Il y a donc de fortes 
chances pour qu'il y ait d'autres données à la suite de 
cette chaîne, en mémoire. Lorsqu'on va modifier la 
chaîne (par l'exemple l'agrandir à 30 octets): si on n'a 
pas réservé l'espace suffisant pour cette modifica- 
tion, on va encore écrire allègrement sur des zones 
réservées... et bonjour les dégâts ! 

Pour les mêmes raisons, on va indiquer la taille réelle 
du Handle une fois la chaîne modifiée et prête à être 
sauvée (notez le +1 pour ajouter l'octet de longueur 
de la pString) 


SetHandieSize(length{MyPointer")-1 MyHandle); 


Et enfin on indique au Resource Manager que cette 
ressource à été mise à jour: 


MarkResaurceChange( TRUE, KResType,kResiDT}; 
Update ResourceFile(GetCur ResourceFile); 


Ouf ! ça y est: nous avons réussi à modifier la res- 
source de l'application courante par voie logicielle. 


La suite du listing indique la même modification, 
mais à l'aide de WrifeResource. 


Ne pas oublier de laisser les licux propres en quit- 
tant: On ferme le fichier ressource, on purge les poin- 
teurs {Dispose} et les handles {DispeseAlN) et on ferme 
les outils. 


Moralité 


La programmation en Pascal, pour aisée qu'elle soit, 
requiert une grande rigueur dans les déclarations. 
Lorsqu'on a à faire à des situations délicates, il suffit 
de regarder ce qui se passe en mémoire pour com- 
prendre l'origine de l'erreur. 

A cet cffet, des outils comme Debug Init ou Nifty 
List sont d'un secours immense; mais à défaut on 
peut utiliser une routine d'affichage des pointeurs 
telle que celle décrite ici même. 


Voila, j'espère que cet article vous aura apporté quel- 
ques solutions à vos problèmes, qui, si j'en juge mon | 
courrier, avaient l'air d'être insolubles pour plus d'un 
et d'une, Comme vous l'avez remarqué, le Pascal 
complique un peu les choses, mais on y arrive. 


Dans le prochain numéro, nous poursuivrons l'étude 
des ressources en abordant cette fois la définition de ! 
nos propres types. 
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A.Roybier: Je rencontre des difficultés à charger les 
images et à lancer les programmes des disquettes 
ToolBox Mag. J'utilise GSjOS 4.0, TML Pascal, GS 
Paint, Deluxe Paint Il. 


ToolBox Mag : Votre système est périmé. Nous 
en étions depuis un bon moment au 5.02 français, 
nous en sommes maintenant au 5.04. Avec le 
5.04, vous pourrez lancer PicMaster GS de la dis- 
quette ToolBox Mag 2, qui vous permettra de 
convertir les images GS de toutes sortes dans des 
formats compatibles avec vos applications graphi- 
ques ancicnncs. Mais nous recommandons d'uti- 
liser un programme graphique à jour, comme 
Platinum Paint, (voir ToolBox Mag 3). 

TML Pascal en est aussi depuis un bon moment à 
la version IE (TML Pascal II ou Complete Pascal 
Il), et cette version est nécessaire pour éditer et 
compiler les sources TML Pascal de ToolBox Mag. 


Françoise Lau: Je cherche depuis longtemps un 
programme graphique Desktop, un programme 
d'analyses statistiques genre Stat View sur GS, 
avec statistiques à T et 2 variables, moyenne, écart- 
type, variance et covariance, tracé de régression li- 
néaire, d'histogrammes, etc. Avec bien sûr stockage 
des données dans un fichier sur disque, procédure de 
cumulation successive de données. 


TooiBox Mag : Nous ne connaissons effective- 
ment pas d'application commerciale de ce type. 
Nous pensons que les programmeurs GS, tout 
particulièrement ceux qui programment en Pas- 
cal, devraient être intéressés par cette idée. 


Joël Desnoues: À propos de Crystal Quest. Il y a 
99 niveaux de jeu en tout (!). J'ai découvert l'empla- 
cement où sont stockées les principales informations 
du jeu. Après avoir installé “Visit Monitor” et lancé 
Crystal Quest, passez sous moniteur et listez en 
$00/0A30: 


0A30: 000000 Total des points 





0A40: 00 Niveau de jeu 
OA44: 00 00 Nombre de vies 
OAd6: 00 00 Nombre de bombes 
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Coumne des Lecteurs 


OA4A: 00 00 Secondes. 





Î 
OA48: 00 00 Minutes | 
| 


Toutes ces valeurs sont en décimal, avec l'octet de 
poids faible en premier. Pokez les valeurs souhaitées 
aux bons emplacements pour découvrir fous les ni- 
veaux ef éviter fout risque de foulure du poignet à 
Hubert. 


ToolBox Mag : Votre truc ne produit pas exacte 
ment l'effet prévu: en tentant de battre nos scores 
faramineux, Hubert a frôlé de près la foulure… 


R.Burger: Vos lecteurs ne sont pas forcément aussi 
à l'aise que vous avec les Tools: s'il vous plait, 
n'ayez pas peur d'être explicites dans les commen- 
taires des listings. D'autre part, il est assez désagré- 
able de se trouver devant un source inexploitable 
parce qu'on n'a pas le langage adéquat. ToolBox 
Mag ne pourrait-il pas adopter un langage unique? 


ToolBox Mag : Vos demandes sont légitimes, et 
vous noterez, dans ce numéro même, notre effort 
pour les satisfaire. 

Pour la seconde demande, plutôt que d'appauvrir 
le G$ (la pluralité des langages est une richesse, 
nous attendons vos sources Forth où Micol Basic), 
et de brider la liberté des programmeurs (pas de 
galère sur GS !), nous nous aiguillons vers la Hsf- 
bilité, voire la traductibiitté des programmes- 
sources. Nous espérons que la formule du plan, 
du synoptique du programme (ou même du pro- 
jet de programme) sera reprisc par de nombreux 
auteurs. 

Par ailleurs, la formule d'avenir pour la program- 
mation du GS est bien dans l'usage de plusieurs 
langages ensemble dans le même programme, un 
Linker se chargeant de coller les morceaux. 

Si vous cherchez le meilleur investissement pour 
programmer le GS, nous vous recommandons 
donc: 

+ Genesys, de SSSI, pour les ressources, €t : 

+ L'environnement de développement intégré 
Orca (ByteWorks), dans lequel vous pourrez in- 
tégrer tous les langages, en commençant par celui 
que vous préférez. 
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